Method: partners.devices.claim

Revendiquer un appareil pour un client et l'ajouter à l'enregistrement sans contact Si l'appareil est déjà revendiqué par un autre client, l'appel renvoie une erreur.

Requête HTTP

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
partnerId

string (int64 format)

Obligatoire. ID du partenaire revendeur.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
deviceIdentifier

object (DeviceIdentifier)

Obligatoire. Obligatoire. Identifiant de l'appareil à revendiquer.
sectionType

enum (DeviceProvisioningSectionType)

Obligatoire. Type de section de l'enregistrement de provisionnement de l'appareil.
deviceMetadata

object (DeviceMetadata)

Facultatif. Métadonnées à associer à l'appareil.
preProvisioningToken

string

Facultatif. Doit et ne peut être défini que pour les appareils Chrome OS.
Champ d'union customer. Obligatoire. Client au nom duquel l'appareil est revendiqué. customer ne peut être qu'un des éléments suivants :
customerId

string (int64 format)

Identifiant du client pour lequel l'appareil est revendiqué.
googleWorkspaceCustomerId

string

Numéro client Google Workspace.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Message de réponse contenant l'ID de l'appareil utilisé pour la revendication.

Représentation JSON 
{
  "deviceId": string,
  "deviceName": string
}
Champs
deviceId

string (int64 format)

ID de l'appareil revendiqué.
deviceName

string

Nom de ressource de l'appareil au format partners/[PARTNER_ID]/devices/[DEVICE_ID].

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.