Method: mediaItems.list

Renvoie la liste des éléments multimédias sélectionnés par l'utilisateur au cours de la session spécifiée.

Une erreur FAILED_PRECONDITION s'affiche si la session ne comporte pas encore d'éléments multimédias sélectionnés et ne peut donc pas afficher de contenu multimédia. Dans ce scénario, les applications exécutées sur des appareils à entrée limitée doivent afficher un code QR encodant l'pickerUri de la session, invitant l'utilisateur à scanner le code et à sélectionner des éléments multimédias dans l'interface utilisateur du sélecteur de Google Photos. En attendant que l'utilisateur sélectionne ses éléments, les clients doivent interroger sessions.get, une fois toutes les pollingConfig.pollInterval, jusqu'à pickedItemsSet = true dans la réponse sessions.get. À ce stade, les clients peuvent de nouveau appeler mediaItems.list et s'attendre à recevoir une réponse positive.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
sessionId

string

Obligatoire. Identifiant généré par Google pour cette session.
pageSize

integer

Facultatif. Nombre maximal d'éléments multimédias à renvoyer.

Le service peut renvoyer un nombre inférieur à cette valeur (y compris zéro résultat). Si aucune valeur n'est spécifiée ou si la valeur est définie sur 0, 50 éléments multimédias au maximum sont renvoyés. La valeur maximale est 100. Les valeurs supérieures sont réduites à 100. Les valeurs négatives génèrent une erreur INVALID_ARGUMENT.
pageToken

string

Facultatif. Jeton de page reçu d'un appel mediaItems.list précédent. Fournissez-le pour récupérer la page suivante.

Corps de la requête

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

Corps de la réponse

Réponse au RPC mediaItems.list.

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 (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
Champs
mediaItems[]

object (PickedMediaItem)

Page d'éléments multimédias sélectionnés.
nextPageToken

string

Jeton qui peut être envoyé en tant que pageToken pour récupérer la page suivante dans une requête mediaItems.list.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly