Method: mediaItems.batchGet

Zwraca listę elementów multimedialnych dla określonych identyfikatorów elementów multimedialnych. Elementy są zwracane w tej samej kolejności, w jakiej podano identyfikatory.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
mediaItemIds[]

string

Wymagane. Identyfikatory multimediów, których dotyczy żądanie. Nie może zawierać powtarzających się identyfikatorów ani być pusta. Maksymalna liczba elementów multimedialnych, które można pobrać w ramach jednego wywołania, to 50.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź umożliwiająca pobranie listy elementów multimedialnych.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Pola
mediaItemResults[]

object (MediaItemResult)

Tylko dane wyjściowe. Lista pobranych elementów multimedialnych. Pamiętaj, że nawet jeśli wywołanie metody mediaItems.batchGet zakończy się powodzeniem, niektóre elementy multimediów w zbiorze mogły nie zostać pobrane. Te niepowodzenia są opisane w każdym MediaItemResult.status.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

MediaItemResult

Wynik pobierania elementu multimedialnego.

Zapis JSON 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Pola
status

object (Status)

Jeśli podczas uzyskiwania dostępu do tego elementu multimedialnego wystąpił błąd, w tym polu pojawią się informacje związane z tym błędem. Szczegółowe informacje na temat tego pola można znaleźć na stronie Status.
mediaItem

object (MediaItem)

Element multimedialny pobrany z biblioteki użytkownika. Jest wypełniony, jeśli nie wystąpiły żadne błędy i udało się pobrać element multimedialny.