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 |
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 |
pageToken |
Fortsetzungs-Token für den Abruf der nächsten Ergebnisseite. Wenn Sie diesen Wert in die Anfrage einfügen, werden die Zeilen nach |
excludeNonAppCreatedData |
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 ( |
Felder | |
---|---|
albums[] |
Nur Ausgabe Liste der Alben, die auf dem Tab „Alben“ in der Google Fotos App des Nutzers angezeigt wird. |
nextPageToken |
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