- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
Rivendica un dispositivo per un cliente e lo aggiunge alla registrazione zero-touch. Se il dispositivo è già stato rivendicato da un altro cliente, la chiamata restituisce un errore.
Richiesta HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
partnerId |
Obbligatorio. L'ID del partner rivenditore. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "deviceIdentifier": { object ( |
Campi | |
---|---|
deviceIdentifier |
Obbligatorio. Obbligatorio. L'identificatore del dispositivo da richiedere. |
sectionType |
Obbligatorio. Il tipo di sezione del record di provisioning del dispositivo. |
deviceMetadata |
(Facoltativo) I metadati da allegare al dispositivo. |
preProvisioningToken |
(Facoltativo) Deve essere e può essere impostato solo per i dispositivi ChromeOS. |
Campo unione customer . Obbligatorio. Il cliente per il quale il dispositivo viene rivendicato. customer può essere solo uno dei seguenti: |
|
customerId |
L'ID del cliente per il quale il dispositivo viene rivendicato. |
googleWorkspaceCustomerId |
L'ID cliente di Google Workspace. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Messaggio di risposta contenente l'ID dispositivo della rivendicazione.
Rappresentazione JSON |
---|
{ "deviceId": string, "deviceName": string } |
Campi | |
---|---|
deviceId |
L'ID del dispositivo rivendicato. |
deviceName |
Il nome della risorsa del dispositivo nel formato |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidworkprovisioning
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.