Method: sharedAlbums.list

Hier werden alle geteilten Alben aufgeführt, 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. 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 listSharedAlbums-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“, d. h., es werden alle Alben 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, mit dem die nächsten geteilten Alben abgerufen werden. Wird ausgefüllt, wenn für diese Anfrage weitere freigegebene Alben abgerufen werden sollen.

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