Method: mediaItems.batchGet

Zwraca listę elementów multimedialnych dla określonych identyfikatorów elementów multimedialnych. Produkty są zwracane w tej samej kolejności co podane 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 elementów multimedialnych, których ma dotyczyć żądanie. Nie może zawierać powtarzających się identyfikatorów ani być pusty. 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. Pobrano listę elementów multimedialnych. Pamiętaj, że nawet jeśli wywołanie mediaItems.batchGet się powiedzie, mogą wystąpić błędy dotyczące niektórych elementów multimedialnych w wsadzie. Te błędy są wskazywane 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 został pobrany z biblioteki użytkownika. Ta wartość jest wypełniona, jeśli nie wystąpiły żadne błędy, a element multimedialny został pobrany.