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 können weniger Alben zurückgegeben werden als die angegebene Anzahl. Der Standardwert für pageSize ist 20, der Höchstwert ist 50.
pageToken

string

Fortsetzungs-Token zum Aufrufen der nächsten Seite der Ergebnisse. Wenn Sie dies der 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“ (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 zum Abrufen des nächsten Satzes geteilter Alben. 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