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

Maximale Anzahl von Medienelementen, 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-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 zum Abrufen des nächsten Satzes von Medienelementen. Ihr Vorhandensein 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