Method: mediaItems.batchGet

Retorna a lista de itens de mídia dos identificadores especificados de itens de mídia. Os itens são retornados na mesma ordem que os 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 estar em branco. 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.

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. Observe que mesmo que a chamada para mediaItems.batchGet seja bem-sucedida, pode ter ocorrido 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 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 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 esse item de mídia, este campo será preenchido com as informações relacionadas ao erro. Para mais detalhes sobre esse campo, consulte Status.
mediaItem

object (MediaItem)

Item de mídia recuperado da biblioteca do usuário. Ele será preenchido se não houver erros e o item de mídia tiver sido buscado.