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 renvoyés dans le même ordre que les 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 peut pas être vide. Le nombre maximal d'éléments multimédias pouvant être récupérés par 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 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, des échecs peuvent se produire pour certains éléments multimédias du lot. 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, les informations liées à l'erreur sont insérées dans ce champ. 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é.