Method: albums.list

Elenca tutti gli album mostrati a un utente nella scheda Album dell'app Google Foto.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
pageSize

integer

Numero massimo di album da restituire nella risposta. È possibile che venga restituito un numero inferiore di album rispetto al numero specificato. Il valore predefinito per pageSize è 20, il massimo è 50.
pageToken

string

Un token di continuazione per visualizzare la pagina successiva dei risultati. Se aggiungi questo elemento alla richiesta, vengono restituite le righe che seguono pageToken. pageToken deve essere il valore restituito nel parametro nextPageToken nella risposta alla richiesta listAlbums.
excludeNonAppCreatedData

boolean

Se impostato, i risultati escludono gli elementi multimediali non creati da questa app. Il valore predefinito è false (vengono restituiti tutti gli album). Questo campo viene ignorato se viene utilizzato l'ambito photoslibrary.readonly.app createddata.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Elenco degli album richiesti.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "albums": [
    {
      object (Album)
    }
  ],
  "nextPageToken": string
}
Campi
albums[]

object (Album)

Solo output. Elenco di album visualizzati nella scheda Album dell'app Google Foto dell'utente.
nextPageToken

string

Solo output. Token da utilizzare per ottenere il prossimo insieme di album. Compilato se sono presenti altri album da recuperare per questa richiesta.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata