Method: mediaItems.list

Listet alle Medienelemente aus der Google Fotos-Mediathek eines Nutzers auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
pageSize

integer

Die maximale Anzahl der Medienelemente, die in der Antwort zurückgegeben werden sollen. Es werden möglicherweise weniger Medienelemente zurückgegeben als die angegebene Anzahl. Der Standardwert für pageSize ist 25, der Höchstwert 100.
pageToken

string

Ein Fortsetzungstoken, mit dem die nächste Ergebnisseite abgerufen wird. Wenn Sie diese Zeile zur 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, mit dem die nächsten Medienelemente abgerufen werden. 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals