Method: mediaItems.batchGet

Devuelve la lista de elementos multimedia para los identificadores de elementos multimedia especificados. Los elementos 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 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, incluso si la llamada a mediaItems.batchGet se realiza correctamente, es posible que haya habido fallas en algunos elementos multimedia del lote. Estos errores se indican en cada MediaItemResult.status.

Permisos 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

MediaItemResult

Es el 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 propaga 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 produjo ningún error y se recuperó correctamente el elemento multimedia.