Method: albums.list

Liste tous les albums présentés à un utilisateur dans l'onglet "Albums" de l'application Google Photos.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal d'albums à renvoyer dans la réponse. Le nombre d'albums renvoyés peut être inférieur à celui spécifié. La valeur par défaut de pageSize est 20, la valeur maximale est 50.
pageToken

string

Jeton de continuation permettant d'obtenir la page suivante des résultats. L'ajout de cette valeur à la requête renvoie les lignes après pageToken. pageToken doit être la valeur renvoyée dans le paramètre nextPageToken dans la réponse à la requête listAlbums.
excludeNonAppCreatedData

boolean

Si cette règle est définie, les résultats excluent les éléments multimédias qui n'ont pas été créés par cette application. La valeur par défaut est "false" (tous les albums sont renvoyés). Ce champ est ignoré si le champ d'application photoslibrary.readonly.appcreateddata est utilisé.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Liste des albums demandés.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "albums": [
    {
      object (Album)
    }
  ],
  "nextPageToken": string
}
Champs
albums[]

object (Album)

Uniquement en sortie. Liste des albums affichés dans l'onglet "Albums" de l'application Google Photos de l'utilisateur.
nextPageToken

string

Uniquement en sortie. Jeton à utiliser pour obtenir l'ensemble d'albums suivant. Inséré s'il existe d'autres albums à récupérer pour cette requête.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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