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 del 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 richiedere.
sectionType

enum (DeviceProvisioningSectionType)

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

object (DeviceMetadata)

(Facoltativo) I metadati da allegare al dispositivo.
preProvisioningToken

string

(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

string (int64 format)

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

string

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

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 di OAuth 2.0.