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. Potrebbero essere restituiti meno album rispetto al numero specificato. Il valore predefinito di pageSize è 20, il 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 che non sono stati creati da questa app. Il valore predefinito è false (vengono restituiti tutti gli album). Questo campo viene ignorato se viene utilizzato l'ambito photoslibrary.readonly.appcreatedata.

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

string

Solo output. Token da utilizzare per ottenere il successivo 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