Method: mediaItems.batchGet

Muestra la lista de elementos multimedia de los identificadores de elementos multimedia especificados. Los artículos se muestran 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. Son los identificadores de los elementos multimedia que se solicitarán. No debe contener identificadores repetidos y no puede estar vacío. La cantidad máxima de elementos multimedia que se pueden recuperar en una llamada es 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. Se recuperó la lista de elementos multimedia. Ten en cuenta que, incluso si la llamada a mediaItems.batchGet se realiza correctamente, es posible que se hayan producido errores en algunos elementos multimedia del lote. Estas fallas se indican en cada MediaItemResult.status.

Permisos de autorización

Se necesita uno de los siguientes alcances 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 propagará con información relacionada con el error. Para obtener detalles sobre este campo, consulta Status.

mediaItem

object (MediaItem)

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