Method: mediaItems.batchGet

Muestra la lista de elementos multimedia para los identificadores de elementos multimedia especificados. Los artículos se devuelven en el mismo orden que los identificadores proporcionados.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
mediaItemIds[]

string

Obligatorio. Identificadores de los elementos multimedia que se solicitarán. No debe contener identificadores repetidos ni estar vacío. La cantidad máxima de elementos multimedia que se pueden recuperar en una llamada es de 50.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta para recuperar una lista de elementos multimedia.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Campos
mediaItemResults[]

object (MediaItemResult)

Solo salida. Lista de elementos multimedia recuperados. Ten en cuenta que, aunque la llamada a mediaItems.batchGet se realice correctamente, es posible que se hayan producido errores en algunos elementos multimedia del lote. Estas fallas se indican en cada MediaItemResult.status.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata

MediaItemResult

Resultado de la recuperación de un elemento multimedia.

Representación JSON 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Campos
status

object (Status)

Si se produjo un error al acceder a este elemento multimedia, este campo se completará con información relacionada con el error. Para obtener más información sobre este campo, consulta Status.
mediaItem

object (MediaItem)

Es el elemento multimedia recuperado de la biblioteca del usuario. Se propaga si no se produjeron errores y el elemento multimedia se recuperó correctamente.