Method: mediaItems.list

Hiermit werden alle Medienelemente aus der Google Fotos-Galerie eines Nutzers aufgelistet.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
pageSize

integer

Maximale Anzahl von Medienelementen, die in der Antwort zurückgegeben werden sollen. Möglicherweise werden weniger Medienelemente als die angegebene Anzahl zurückgegeben. Der Standardwert für pageSize ist 25, der Maximalwert ist 100.
pageToken

string

Fortsetzungs-Token für den Abruf der nächsten Ergebnisseite. Wenn Sie diesen Wert in die Anfrage einfügen, werden die Zeilen nach pageToken zurückgegeben. pageToken sollte der Wert sein, der im Parameter nextPageToken in der Antwort auf die listMediaItems-Anfrage zurückgegeben wird.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Liste aller Medienelemente aus der Google Fotos-Galerie des Nutzers.

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

JSON-Darstellung 
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "nextPageToken": string
}
Felder
mediaItems[]

object (MediaItem)

Nur Ausgabe Liste der Medienelemente in der Mediathek des Nutzers.
nextPageToken

string

Nur Ausgabe Token, mit dem der nächste Satz von Medienelementen abgerufen wird. Ihre Anwesenheit ist der einzige zuverlässige Indikator dafür, dass in der nächsten Anfrage mehr Medienelemente verfügbar sind.

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