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 query

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 di pageSize è 20, il valore massimo è 50.
pageToken

string

Un token di continuazione per ottenere la pagina successiva dei risultati. L'aggiunta di questo valore alla richiesta restituisce le righe dopo 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.appcreateddata.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Elenco di 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 degli album visualizzati nella scheda Album dell'app Google Foto dell'utente.
nextPageToken

string

Solo output. Token da utilizzare per ottenere il gruppo di album successivo. Viene compilato se ci sono 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals