Method: mediaItems.list

Retorna uma lista de itens de mídia escolhidos pelo usuário durante a sessão especificada.

Um erro FAILED_PRECONDITION será retornado se o usuário ainda não tiver terminado de escolher os itens de mídia para a sessão especificada. Nesse cenário, o app precisa pesquisar sessions.get até que a sessão esteja pronta antes de tentar o método novamente.

Solicitação HTTP

GET https://photospicker.googleapis.com/v1/mediaItems

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

Parâmetros de consulta

Parâmetros
sessionId

string

Obrigatório. Identificador gerado pelo Google para esta sessão.
pageSize

integer

Opcional. O número máximo de itens de mídia a serem retornados.

O serviço pode retornar menos que esse valor (incluindo zero resultados). Se não for especificado ou definido como 0, no máximo 50 itens de mídia serão retornados. O valor máximo é 100. Valores acima disso vão ser convertidos para 100. Valores negativos resultarão em um erro INVALID_ARGUMENT.
pageToken

string

Opcional. Um token de página recebido de uma chamada mediaItems.list anterior. Forneça isso para recuperar a página subsequente.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para o método mediaItems.list.

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

Representação JSON 
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
Campos
mediaItems[]

object (PickedMediaItem)

Uma página de itens de mídia selecionados.
nextPageToken

string

Se definido, esse campo pode ser usado como pageToken em uma chamada mediaItems.list subsequente para recuperar a próxima página dos itens de mídia selecionados.

Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly