Method: albums.list

Listet alle Alben auf, die einem Nutzer auf dem Tab „Alben“ 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. Es werden möglicherweise weniger Alben als die angegebene Anzahl zurückgegeben. Der Standardwert für pageSize ist 20, der Höchstwert ist 50.
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 listAlbums-Anfrage zurückgegeben wird.
excludeNonAppCreatedData

boolean

Wenn festgelegt, werden in den Ergebnissen keine Medienelemente angezeigt, die nicht von dieser App erstellt wurden. Die Standardeinstellung 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 werden.
nextPageToken

string

Nur Ausgabe. Token zum Abrufen des nächsten Satzes von Alben. 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