Method: mediaItems.batchGet

Retorna a lista de itens de mídia 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 e não pode ficar 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 extrair 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. Mesmo que a chamada para mediaItems.batchGet tenha êxito, pode ter havido falhas em alguns itens de mídia do 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
  • 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 informações relacionadas ao erro. Para mais detalhes sobre este campo, consulte Status.
mediaItem

object (MediaItem)

Item de mídia recuperado da biblioteca do usuário. Ele será preenchido se nenhum erro tiver ocorrido e se o item de mídia tiver sido buscado corretamente.