Method: sessions.create

Gera uma nova sessão em que o usuário pode escolher fotos e vídeos para acesso de terceiros.

Se o usuário não tiver uma conta ativa do Google Fotos, um erro FAILED_PRECONDITION será retornado.

Se o aplicativo cliente criar muitas sessões por usuário, um erro RESOURCE_EXHAUSTED será retornado. É improvável que os clientes atinjam esses limites em circunstâncias normais. No entanto, ainda é recomendável que os clientes chamem sessions.delete após cada sessão para permanecer dentro dos limites de recursos.

Quando um usuário toca no botão Concluído para concluir uma sessão de seleção, o pickerUri não funciona mais. Crie uma nova sessão para permitir que o usuário escolha mais fotos.

Solicitação HTTP

POST https://photospicker.googleapis.com/v1/sessions

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

Parâmetros de consulta

Parâmetros
requestId

string

Opcional. Um identificador exclusivo fornecido pelo cliente para essa solicitação.

Esse ID é usado para ativar a experiência de seleção simplificada para aplicativos que usam o fluxo OAuth 2.0 para dispositivos de entrada limitada.

Esse ID precisa ter o formato de uma string UUID (versão 4) e seguir estes requisitos:

  • Não pode conter informações sensíveis de identificação do usuário.
  • Precisa conter 32 caracteres hexadecimais divididos em cinco grupos separados por hifens, no formato "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (ou 8-4-4-4-12).

Corpo da solicitação

O corpo da solicitação contém uma instância de PickingSession.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de PickingSession.

Escopos de autorização

Requer o seguinte escopo OAuth:

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