Method: mediaItems.batchGet

Gibt die Liste der von der App erstellten Medienelemente für die angegebenen Medienelement-IDs zurück. Die Artikel werden in der Reihenfolge der angegebenen IDs 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 angeforderten 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 der von der App erstellten Medienelemente.

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 jeder MediaItemResult.status angezeigt.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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. Sie wird ausgefüllt, wenn keine Fehler aufgetreten sind und das Medienelement erfolgreich abgerufen wurde.