Method: mediaItems.list

Répertorier tous les éléments multimédias de la bibliothèque Google Photos d'un utilisateur.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal d'éléments multimédias à renvoyer dans la réponse. Le nombre d'éléments multimédias affichés peut être inférieur au nombre spécifié. La valeur par défaut de pageSize est 25, la valeur maximale est 100.
pageToken

string

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

Corps de la requête

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

Corps de la réponse

Liste de tous les éléments multimédias de la bibliothèque Google Photos de l'utilisateur.

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

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

object (MediaItem)

Uniquement en sortie. Liste des éléments multimédias de la bibliothèque de l'utilisateur.
nextPageToken

string

Uniquement en sortie. Jeton à utiliser pour obtenir l'ensemble d'éléments multimédias suivant. Sa présence est le seul indicateur fiable s'il y a davantage d'éléments multimédias disponibles dans la prochaine 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