Method: mediaItems.batchGet

Zwraca listę elementów multimedialnych dla określonych identyfikatorów elementów multimedialnych. Produkty są zwracane w takiej 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

To pole jest wymagane. Identyfikatory elementów multimedialnych, w przypadku których chcesz wysłać żądanie. Pole nie może zawierać powtarzających się identyfikatorów ani być puste. Maksymalna liczba elementów multimedialnych, które można pobrać w ramach jednego połączenia, to 50.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na 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 mediaItems.batchGet się powiedzie, w przypadku niektórych elementów multimedialnych w grupie mogły wystąpić błędy. Te błędy są wskazywane w każdym polu MediaItemResult.status.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

MediaItemResult

Wynik pobrania elementu multimedialnego.

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

object (Status)

Jeśli podczas uzyskiwania dostępu do danego elementu multimedialnego wystąpił błąd, to pole zawiera związane z nim informacje. Szczegółowe informacje o tym polu znajdziesz na stronie Status.
mediaItem

object (MediaItem)

Element multimedialny został pobrany z biblioteki użytkownika. Jest ona wypełniana, jeśli nie wystąpiły żadne błędy i element multimedialny został pobrany.