Method: mediaItems.batchGet

Retorna a lista de itens de mídia criados pelo app para os identificadores de item de mídia especificados. Os itens são retornados na mesma ordem dos identificadores fornecidos.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
mediaItemIds[]

string

Obrigatório. Identificadores dos itens de mídia a serem solicitados. Não pode conter identificadores repetidos nem ficar vazio. O número máximo de itens de mídia que podem ser recuperados em uma chamada é 50.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para recuperar uma lista de itens de mídia criados pelo app.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Campos
mediaItemResults[]

object (MediaItemResult)

Apenas saída. Lista de itens de mídia recuperados. Mesmo que a chamada para mediaItems.batchGet seja bem-sucedida, pode ter havido falhas em alguns itens de mídia no lote. Essas falhas são indicadas em cada MediaItemResult.status.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

MediaItemResult

Resultado da recuperação de um item de mídia.

Representação JSON 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Campos
status

object (Status)

Se ocorrer um erro ao acessar o item de mídia, esse campo será preenchido com informações relacionadas ao erro. Para saber mais sobre esse campo, consulte Status.
mediaItem

object (MediaItem)

Item de mídia recuperado da biblioteca do usuário. Ele é preenchido se nenhum erro ocorreu e o item de mídia foi buscado.