Method: devices.create

Crea un dispositivo Ambient nell'account Google Foto dell'utente.

Se esiste già un dispositivo con il requestId fornito, viene restituito un errore ALREADY_EXISTS. Per evitare dispositivi duplicati:

  • Se conosci il deviceId del dispositivo esistente, chiama devices.get per recuperarlo.
  • Se non conosci il codice deviceId, chiama devices.delete con il codice requestId per rimuovere il dispositivo orfano prima di riprovare questo metodo.

Puoi creare fino a 100 dispositivi per utente della tua app. Se questo limite viene superato, viene restituito un errore RESOURCE_EXHAUSTED.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
requestId

string

Facoltativo. Un identificatore univoco fornito dal cliente per questa richiesta. Viene utilizzato per ridurre la duplicazione delle risorse in caso di guasto della rete.

Questo ID deve avere il formato di una stringa UUID (versione 4) e soddisfare i seguenti requisiti:

  • Non deve contenere informazioni di identificazione sensibili sull'utente.
  • Deve contenere 32 caratteri esadecimali suddivisi in cinque gruppi separati da trattini, nel formato "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (o 8-4-4-4-12).

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di AmbientDevice.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di AmbientDevice appena creata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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