Method: albums.list

Listet alle Alben auf, die Nutzern auf dem Tab „Alben“ in der Google Fotos App angezeigt werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
pageSize

integer

Maximale Anzahl der Alben, die in der Antwort zurückgegeben werden sollen. Möglicherweise werden weniger Alben zurückgegeben als die angegebene Anzahl. Der Standardwert für pageSize ist 20, der Maximalwert ist 50.
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 listAlbums-Anfrage zurückgegeben wird.
excludeNonAppCreatedData

boolean

Wenn festgelegt, enthalten die Ergebnisse keine Medienelemente, die nicht von dieser App erstellt wurden. Der Standardwert ist „false“ (alle Alben werden zurückgegeben). Dieses Feld wird ignoriert, wenn der Bereich „photoslibrary.readonly.appcreateddata“ verwendet wird.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Liste der angeforderten Alben.

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

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

object (Album)

Nur Ausgabe Liste der Alben, die auf dem Tab „Alben“ in der Google Fotos App des Nutzers angezeigt wird.
nextPageToken

string

Nur Ausgabe Token, mit dem die nächste Gruppe von Alben abgerufen wird. Wird ausgefüllt, wenn für diese Anfrage weitere Alben abgerufen werden können.

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