Method: sharedAlbums.list

Listet alle geteilten Alben auf, die auf dem Tab „Teilen“ in der Google Fotos App des Nutzers verfügbar sind.

HTTP-Anfrage

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

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 listSharedAlbums-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 geteilten Alben.

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

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

object (Album)

Nur Ausgabe Liste der geteilten Alben.
nextPageToken

string

Nur Ausgabe Token, das zum Abrufen der nächsten geteilten Alben verwendet wird. Wird ausgefüllt, wenn für diese Anfrage weitere geteilte 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