Method: mediaItems.batchGet

Affiche la liste des éléments multimédias pour les identifiants d'éléments multimédias spécifiés. Les articles sont retournés dans le même ordre que celui associé à leurs codes produit.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
mediaItemIds[]

string

Obligatoire. Identifiants des éléments multimédias à demander. Ne doit pas contenir d'identifiants répétés et ne peut pas être vide. Le nombre maximal d'éléments multimédias pouvant être récupérés dans un appel est de 50.

Corps de la requête

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

Corps de la réponse

Réponse permettant de récupérer la liste des éléments multimédias.

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

Représentation JSON
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Champs
mediaItemResults[]

object (MediaItemResult)

Uniquement en sortie. Liste des éléments multimédias récupérée. Notez que même si l'appel de mediaItems.batchGet aboutit, certains éléments multimédias du lot peuvent avoir échoué. Ces échecs sont indiqués dans chaque MediaItemResult.status.

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

Résultat MediaItem

Résultat de la récupération d'un élément multimédia.

Représentation JSON
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Champs
status

object (Status)

Si une erreur s'est produite lors de l'accès à cet élément multimédia, ce champ contient des informations concernant l'erreur. Pour en savoir plus sur ce champ, consultez Status.

mediaItem

object (MediaItem)

Élément multimédia récupéré dans la bibliothèque de l'utilisateur. Il est renseigné si aucune erreur ne s'est produite et que l'élément multimédia a bien été récupéré.