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 IDs 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 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, wird dieses Feld mit Informationen zum Fehler ausgefüllt. 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.