Method: mediaItems.batchGet

Zwraca listę elementów multimedialnych dla podanych 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ć pusty. Maksymalna liczba elementów multimedialnych, które można pobrać w jednym wywołaniu, to 50.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie pobrania 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 błędy są wskazywane w każdym 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

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, to pole zostanie wypełnione informacjami o tym błędzie. Szczegółowe informacje o tym polu znajdziesz w artykule 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.