Method: mediaItems.batchGet

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

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 Kennungen 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 war, kann es bei einigen Medienelementen im Batch zu Fehlern gekommen sein. Diese Fehler werden in jedem MediaItemResult.status angegeben.

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 zum Fehler. Weitere Informationen zu diesem Feld finden Sie unter Status.
mediaItem

object (MediaItem)

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