- 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 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 rivendicare. |
sectionType |
Obbligatorio. Il tipo di sezione del record di provisioning del dispositivo. |
deviceMetadata |
Campo facoltativo. I metadati da collegare al dispositivo. |
preProvisioningToken |
Campo facoltativo. Deve e può essere impostata solo per i dispositivi Chrome OS. |
Campo di unione customer . Obbligatorio. Il cliente per il quale il dispositivo è stato rivendicato. customer può essere solo uno dei seguenti: |
|
customerId |
L'ID del cliente per il quale il dispositivo è stato rivendicato. |
googleWorkspaceCustomerId |
L'ID cliente 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 su OAuth 2.0.