Method: mediaItems.list

Répertorier tous les éléments multimédias d'une 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 à afficher dans la réponse. Le nombre d'éléments multimédias pouvant être renvoyés est 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 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 listMediaItems.

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 de tous les éléments multimédias de la bibliothèque Google Photos de l'utilisateur.

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 permettant d'obtenir l'ensemble suivant d'éléments multimédias. Sa présence est le seul indicateur fiable d'un plus grand nombre d'éléments multimédias disponibles dans la requête suivante.

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