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 der Medienelemente, die in der Antwort zurückgegeben werden sollen. Es können weniger Medienelemente zurückgegeben werden als die angegebene Zahl. Der Standardwert für pageSize ist 25, der Höchstwert ist 100.
pageToken

string

Fortsetzungs-Token zum Aufrufen der nächsten Seite der Ergebnisse. Wenn Sie dies der Anfrage hinzufü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-Mediathek 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 zum Abrufen des nächsten Satzes von Medienelementen. Das Vorhandensein dieses Parameters ist der einzige zuverlässige Indikator dafür, dass in der nächsten Anfrage weitere 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