Поделиться через


Получение пакета

Пространство имен: 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/..."
}