Method: devices.create

Crea un dispositivo ambiente en la cuenta de Google Fotos del usuario.

Si ya existe un dispositivo con el requestId proporcionado, se muestra un error ALREADY_EXISTS. Para evitar dispositivos duplicados, haz lo siguiente:

  • Si conoces el deviceId del dispositivo existente, llama a devices.get para recuperarlo.
  • Si no conoces el deviceId, llama a devices.delete con el requestId para quitar el dispositivo huérfano antes de volver a intentar este método.

Puedes crear hasta 100 dispositivos por usuario de tu app. Si se supera ese límite, se muestra un error RESOURCE_EXHAUSTED.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
requestId

string

Opcional. Es un identificador único que proporciona el cliente para esta solicitud. Se usa para mitigar la duplicación de recursos en caso de una falla de red.

Este ID debe tener el formato de una cadena de UUID (versión 4) y cumplir con los siguientes requisitos:

  • No debe contener información de identificación sensible sobre el usuario.
  • Debe contener 32 caracteres hexadecimales divididos en cinco grupos separados por guiones, en el formato “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” (o 8-4-4-4-12).

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de AmbientDevice.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de AmbientDevice.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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