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 50.
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 listAlbums-Anfrage zurückgegeben wird.
excludeNonAppCreatedData

boolean

Wenn diese Option festgelegt ist, werden aus den Ergebnissen Medienelemente ausgeschlossen, die nicht von dieser App erstellt wurden. Standardmäßig ist „false“ (alle Alben werden zurückgegeben) festgelegt. 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, mit dem die nächsten Alben abgerufen werden. Wird ausgefüllt, wenn für diese Anfrage noch weitere Alben abgerufen werden müssen.

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