Method: mediaItems.batchGet

Gibt die Liste der Medienelemente für die angegebenen Medienelement-IDs zurück Die Artikel werden in der gleichen Reihenfolge wie die angegebenen Kennzeichnungen zurückgegeben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
mediaItemIds[]

string

Erforderlich. IDs der anzufordernden Medienelemente. Darf keine wiederholten Kennzeichnungen enthalten und darf nicht leer sein. Die maximale Anzahl von Medienelementen, die in einem Aufruf abgerufen werden können, beträgt 50.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort zum Abrufen einer Liste von Medienelementen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Felder
mediaItemResults[]

object (MediaItemResult)

Nur Ausgabe Liste der abgerufenen Medienelemente. Auch wenn der Aufruf von mediaItems.batchGet erfolgreich ist, können bei einigen Medienelementen im Batch Fehler aufgetreten sein. Diese Fehler werden in jeder MediaItemResult.status angezeigt.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

MediaItemResult

Ergebnis des Abrufens eines Medienelements.

JSON-Darstellung 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Felder
status

object (Status)

Wenn beim Zugriff auf dieses Medienelement ein Fehler aufgetreten ist, enthält dieses Feld Informationen zu dem Fehler. Weitere Informationen zu diesem Feld findest du unter Status.
mediaItem

object (MediaItem)

Medienelement aus der Bibliothek des Nutzers abgerufen. Es wird ausgefüllt, wenn keine Fehler aufgetreten sind und das Medienelement erfolgreich abgerufen wurde.