Method: mediaItems.list

Permet de 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 à afficher 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, et la valeur maximale est 100.
pageToken

string

Un jeton de continuation pour obtenir la page de résultats suivante. Si vous l'ajoutez à la requête, vous obtenez les lignes après pageToken. pageToken doit être 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 dans la bibliothèque de l'utilisateur.
nextPageToken

string

Uniquement en sortie. Jeton à utiliser pour obtenir le prochain ensemble d'éléments multimédias. Sa présence est le seul indicateur fiable de la disponibilité d'un plus grand nombre d'éléments multimédias 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