Method: mediaItems.batchGet

Возвращает список элементов мультимедиа для указанных идентификаторов элементов мультимедиа. Элементы возвращаются в том же порядке, что и предоставленные идентификаторы.

HTTP-запрос

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet

URL-адрес использует синтаксис транскодирования gRPC .

Параметры запроса

Параметры
mediaItemIds[]

string

Необходимый. Идентификаторы запрашиваемых медиа-элементов. Не должен содержать повторяющихся идентификаторов и не может быть пустым. Максимальное количество элементов мультимедиа, которые можно получить за один вызов, — 50.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ на получение списка элементов мультимедиа.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Поля
mediaItemResults[]

object ( MediaItemResult )

Только вывод. Список полученных медиа-элементов. Обратите внимание: даже если вызов mediaItems.batchGet завершится успешно, для некоторых элементов мультимедиа в пакете могли возникнуть сбои. Эти сбои указаны в каждом MediaItemResult.status .

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

Медиаитемрезультат

Результат получения медиа-элемента.

JSON-представление
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Поля
status

object ( Status )

Если при доступе к этому элементу мультимедиа произошла ошибка, это поле заполняется информацией, связанной с ошибкой. Подробную информацию об этом поле см. в разделе Status .

mediaItem

object ( MediaItem )

Медиа-элемент, полученный из библиотеки пользователя. Он заполняется, если ошибок не произошло и элемент мультимедиа был успешно получен.