Method: devices.create

Cria um dispositivo ambiente na conta do Google Fotos do usuário.

Se um dispositivo com o requestId fornecido já existir, um erro ALREADY_EXISTS será retornado. Para evitar dispositivos duplicados, faça o seguinte:

  • Se você souber o deviceId do dispositivo, chame devices.get para extraí-lo.
  • Se você não souber o deviceId, chame devices.delete com o requestId para remover o dispositivo órfão antes de tentar novamente.

Você pode criar até 100 dispositivos por usuário do app. Se esse limite for excedido, um erro RESOURCE_EXHAUSTED será retornado.

Solicitação HTTP

POST https://photosambient.googleapis.com/v1/devices

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. Isso é usado para reduzir a duplicação de recursos em caso de falha na rede.

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 AmbientDevice.

Corpo da resposta

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

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/photosambient.mediaitems