Method: mediaItems.list

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

O erro FAILED_PRECONDITION será retornado se a sessão ainda não tiver itens de mídia selecionados e, portanto, não puder retornar conteúdo de mídia. Nesse cenário, os aplicativos executados em dispositivos de entrada limitada precisam renderizar um QR code que codifica o pickerUri da sessão, solicitando que o usuário leia o código e escolha itens de mídia na interface do seletor do Google Fotos. Enquanto aguardam o usuário escolher os itens, os clientes precisam pesquisar sessions.get uma vez a cada pollingConfig.pollInterval até pickedItemsSet = true na resposta sessions.get. Depois disso, os clientes podem voltar a ligar para mediaItems.list e esperar uma resposta bem-sucedida.

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. O identificador gerado pelo Google para a sessão.
pageSize

integer

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

O serviço pode retornar menos do que esse valor (incluindo zero resultados). Se não for especificado ou for definido como 0, no máximo 50 itens de mídia serão retornados. O valor máximo é 100. valores acima de 100 serão 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

Uma resposta à RPC 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

Um token, que pode ser enviado como pageToken para recuperar a próxima página em uma solicitação mediaItems.list.

Escopos de autorização

Requer o seguinte escopo OAuth:

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