Method: partners.devices.claim

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

string (int64 format)

Obbligatorio. L'ID del partner rivenditore.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "sectionType": enum (DeviceProvisioningSectionType),
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "preProvisioningToken": string,
  // Union field customer can be only one of the following:
  "customerId": string,
  "googleWorkspaceCustomerId": string
  // End of list of possible types for union field customer.
}
Campi
deviceIdentifier

object (DeviceIdentifier)

Obbligatorio. Obbligatorio. L'identificatore del dispositivo da rivendicare.
sectionType

enum (DeviceProvisioningSectionType)

Obbligatorio. Il tipo di sezione del record di provisioning del dispositivo.
deviceMetadata

object (DeviceMetadata)

Campo facoltativo. I metadati da collegare al dispositivo.
preProvisioningToken

string

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

string (int64 format)

L'ID del cliente per il quale il dispositivo è stato rivendicato.
googleWorkspaceCustomerId

string

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

string (int64 format)

L'ID del dispositivo rivendicato.
deviceName

string

Il nome della risorsa del dispositivo nel formato partners/[PARTNER_ID]/devices/[DEVICE_ID].

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/androidworkprovisioning

Per ulteriori informazioni, consulta la panoramica su OAuth 2.0.