Method: sharedAlbums.list

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Répertorie tous les albums partagés disponibles dans l'onglet "Partage" de l'application Google Photos de l'utilisateur.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
pageSize

integer

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

pageToken

string

Jeton de continuité pour obtenir la page de résultats suivante. L'ajout à 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 listSharedAlbums.

excludeNonAppCreatedData

boolean

Si ce champ est défini, les éléments multimédias qui n'ont pas été créés par cette application sont exclus. 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

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

Liste des albums partagés demandée.

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

object (Album)

Uniquement en sortie. Liste des albums partagés.

nextPageToken

string

Uniquement en sortie. Jeton permettant d'obtenir le prochain ensemble d'albums partagés. Renseigné s'il y a d'autres albums partagés à 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