Method: mediaItems.batchGet

Affiche la liste des éléments multimédias pour les identifiants d'éléments multimédias spécifiés. Les éléments sont renvoyés dans l'ordre des identifiants fournis.

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 doit pas être vide. Le nombre maximal d'éléments multimédias pouvant être récupérés en une seule fois est de 50.

Corps de la requête

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

Corps de la réponse

Réponse pour récupérer une liste d'é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és. Notez que même si l'appel à mediaItems.batchGet aboutit, il est possible que certains éléments multimédias du lot aient échoué. Ces défaillances sont indiquées 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

MediaItemResult

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 est renseigné avec des informations sur l'erreur. Pour en savoir plus sur ce champ, consultez Status.
mediaItem

object (MediaItem)

Élément multimédia extrait de la bibliothèque de l'utilisateur. Il est renseigné si aucune erreur ne s'est produite et que l'élément multimédia a été extrait avec succès.