Method: mediaItems.list

Répertorie 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 renvoyés peut être inférieur au nombre spécifié. La valeur par défaut de pageSize est 25 et la valeur maximale est 100.
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 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 indiquant que d'autres éléments multimédias seront 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals