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 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 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 noch weitere geteilte 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