Method: mediaItems.batchGet

Renvoie 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 les codes produit 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 peut pas être vide. Le nombre maximal d'éléments multimédias pouvant être récupérés lors d'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 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. La liste des éléments multimédias a été récupérée. Notez que même si l'appel à 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

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 la concernant. 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é.