Получение пакета
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Получите метаданные для пакета на основе уникального идентификатора пакета.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | Не поддерживается. | Не поддерживается. |
Делегированные (личная учетная запись Майкрософт) | Files.Read | Files.Read.All, Files.ReadWrite, Files.ReadWrite.All |
Для приложений | Не поддерживается. | Не поддерживается. |
HTTP-запрос
GET /drive/bundles/{bundle-id}
GET /drive/items/{bundle-id}
Так как пакеты являются элементами, вы можете использовать коллекцию элементов для возврата метаданных о пакете. Вы также можете использовать коллекцию пакетов для удобства, чтобы получить пакет в ответе.
Необязательные параметры запросов
Чтобы ограничить форму объектов, возвращаемых в результате вызова, вы можете использовать параметры запросов OData.
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
if-none-match | Etag. Необязательный параметр. Если этот заголовок запроса включен и предоставленный eTag (или cTag) соответствует текущему тегу в файле, 304 Not Modified возвращается ответ. |
Текст запроса
Не предоставляйте текст запроса с помощью этого метода.
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK
и объект driveItem , содержащий пакет в теле отклика.
Сведения об ответах на ошибки см. в статье Ответы на ошибки Microsoft Graph и типы ресурсов.
Примеры
Пример 1. Получение пакета
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/v1.0/drive/bundles/{bundle-id}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0123456789abc",
"name": "My Photo Album Bundle",
"eTag": "etag",
"cTag": "etag",
"createdBy": { "user": { "id": "1234", "displayName": "Ryan Gregg" } },
"createdDateTime": "datetime",
"lastModifiedBy": { "user": { "id": "1234", "displayName": "Ryan Gregg" } },
"lastModifiedDateTime": "datetime",
"size": 1234,
"webUrl": "http://onedrive.com/...",
"bundle": {
"childCount": 4,
"album": { }
}
}
Пример 2. Получение пакета и его дочерних элементов в одном вызове
expand
Используйте параметр строки запроса, чтобы включить дочерние элементы пакета в тот же запрос, который извлекает метаданные пакета.
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/v1.0/drive/items/{bundle-id}?expand=children
Отклик
Ниже показан пример отклика. Этот вызов возвращает метаданные пакета и список дочерних элементов пакета. Если пакет не имеет дочерних элементов, он возвращает пустую коллекцию.
Если количество дочерних элементов в пакете больше размера страницы по умолчанию, children@odata.nextLink свойство возвращается с URL-адресом, который можно использовать для запроса следующей страницы дочерних элементов в пакете.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "101230100alkc",
"name": "My Cool Day at the Beach",
"children": [
{ "id": "120100abab", "name": "image1.jpg", "file": {} },
{ "id": "120100abo1", "name": "image2.jpg", "file": {} }
],
"children@odata.nextLink": "https://api.onedrive.com/v1.0/..."
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по