REST Resource: partners.devices

Ressource : Device

Un appareil Android ou Chrome OS enregistré pour l'inscription sans contact

Représentation JSON 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ]
}
Champs
deviceId

string (int64 format)

Uniquement en sortie. ID de l'appareil. Attribué par le serveur.
deviceIdentifier

object (DeviceIdentifier)

ID matériels qui identifient un appareil fabriqué. Pour en savoir plus, consultez la section Identifiants.
name

string

Uniquement en sortie. Nom de ressource de l'API au format partners/[PARTNER_ID]/devices/[DEVICE_ID]. Attribué par le serveur.
deviceMetadata

object (DeviceMetadata)

Métadonnées associées à l'appareil. Structurés sous forme de paires clé-valeur. Pour en savoir plus, consultez Métadonnées de l'appareil.
claims[]

object (DeviceClaim)

Uniquement en sortie. Revendications de provisionnement d'un appareil. Les appareils revendiqués pour l'enregistrement sans contact sont associés à une revendication de type SECTION_TYPE_ZERO_TOUCH. Appelez partners.devices.unclaim ou partners.devices.unclaimAsync pour supprimer l'appareil de l'enregistrement sans contact.

DeviceIdentifier

Encapsule les ID matériels et de produit pour identifier un appareil fabriqué. Pour comprendre les exigences concernant les jeux d'identifiants, consultez la page Identifiants.

Représentation JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.

  // Union field hardware_id2 can be only one of the following:
  "imei2": string,
  "meid2": string
  // End of list of possible types for union field hardware_id2.
}
Champs
serialNumber

string

Numéro de série du fabricant de l'appareil. Cette valeur peut ne pas être unique pour les différents modèles d'appareils.
manufacturer

string

Nom du fabricant de l'appareil. Correspond à la valeur intégrée de l'appareil renvoyée par android.os.Build.MANUFACTURER. Les valeurs autorisées sont listées dans Fabricants Android.
model

string

Nom du modèle de l'appareil. Les valeurs autorisées sont listées dans Modèles Android et Modèles Chrome OS.
deviceType

enum (DeviceType)

Type de l'appareil
chromeOsAttestedDeviceId

string

Identifiant fourni par les OEM et utilisé tout au long du processus de production et de vente. Cela ne s'applique qu'aux appareils ChromeOS.
Champ d'union hardware_id. Identifiant matériel basé sur un ID de modem. hardware_id ne peut être qu'un des éléments suivants :
imei

string

Code IMEI de l'appareil. Validé à la saisie.
meid

string

Numéro MEID de l'appareil.
Champ d'union hardware_id2. Deuxième ID matériel, pour les appareils avec double carte SIM. S'il est défini, il doit s'agir du même type d'identifiant que le premier ID matériel. hardware_id2 ne peut être qu'un des éléments suivants :
imei2

string

Deuxième code IMEI de l'appareil.
meid2

string

Deuxième numéro MEID de l'appareil.

DeviceType

Système d'exploitation de l'appareil.

Enums
DEVICE_TYPE_ANDROID Appareil Android
DEVICE_TYPE_CHROME_OS Appareil ChromeOS

DeviceMetadata

Entrées de métadonnées pouvant être associées à une Device. Pour en savoir plus, consultez Métadonnées de l'appareil.

Représentation JSON 
{
  "entries": {
    string: string,
    ...
  }
}
Champs
entries

map (key: string, value: string)

Entrées de métadonnées enregistrées sous forme de paires clé-valeur.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

DeviceClaim

Enregistrement d'un appareil revendiqué par un revendeur pour un client. Les appareils revendiqués dans le cadre de l'enregistrement sans contact sont soumis à une revendication de type SECTION_TYPE_ZERO_TOUCH. Pour en savoir plus, consultez Réclamer des appareils pour des clients.

Représentation JSON 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
Champs
sectionType

enum (DeviceProvisioningSectionType)

Uniquement en sortie. Type de réclamation déposée sur l'appareil.
ownerCompanyId

string (int64 format)

ID du client ayant acheté l'appareil.
googleWorkspaceCustomerId

string

ID du compte Google Workspace auquel appartient l'appareil ChromeOS.
resellerId

string (int64 format)

ID du revendeur qui a revendiqué l'appareil.
additionalService

enum (AdditionalService)

Service supplémentaire enregistré pour l'appareil.

DeviceProvisioningSectionType

Type de section d'un enregistrement de provisionnement.

Enums
SECTION_TYPE_SIM_LOCK Type de section sur le verrouillage de la carte SIM.
SECTION_TYPE_ZERO_TOUCH Type de section "Enregistrement sans contact".

AdditionalService

Service supplémentaire enregistré pour l'appareil.

Enums
DEVICE_PROTECTION Service de protection de l'appareil, également appelé Android Enterprise Essentials. Pour revendiquer un appareil auprès du service de protection de l'appareil, vous devez vous enregistrer auprès de l'équipe Partenariats.

Méthodes

claim

 Revendiquent un appareil pour un client et l'ajoutent à l'enregistrement sans contact.

claimAsync

 Réclame de manière asynchrone un lot d'appareils pour un client.

findByIdentifier

 Recherche les appareils à l'aide d'identifiants matériels, tels que le code IMEI.

findByOwner

 Recherche les appareils revendiqués pour les clients.

get

 Récupère un appareil.

metadata

 Met à jour les métadonnées du revendeur associées à l'appareil.

unclaim

 Révoque la revendication d'un appareil par un client et le supprime de l'enregistrement sans contact.

unclaimAsync

 Réclame de manière asynchrone un lot d'appareils pour un client.

updateMetadataAsync

 Met à jour les métadonnées du revendeur associées à un lot d'appareils.