REST Resource: customers.devices

Ressource: Appareil

Un appareil Android ou ChromeOS enregistré pour l'enregistrement sans contact.

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

string (int64 format)

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

object (DeviceIdentifier)

ID matériel 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 customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Attribué par le serveur.
deviceMetadata

object (DeviceMetadata)

Métadonnées associées à l'appareil. Structurées sous forme de paires clé-valeur.
claims[]

object (DeviceClaim)

Uniquement en sortie. Revendications de provisionnement d'un appareil. Les appareils revendiqués pour l'inscription sans contact sont associés à une revendication de type SECTION_TYPE_ZERO_TOUCH. Appelez customers.devices.unclaim pour retirer l'appareil de l'inscription sans contact.
configuration

string

Configuration appliquée à l'appareil au format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. La valeur est null si aucune configuration n'est appliquée à l'appareil.

DeviceIdentifier

Encapsule les ID matériels et de produit pour identifier un appareil fabriqué. Pour en savoir plus sur les exigences concernant les ensembles d'identifiants, consultez 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. Il est possible que cette valeur ne soit pas unique d'un modèle à l'autre.
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 d'appareil
chromeOsAttestedDeviceId

string

Identifiant fourni par les OEM, 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é lors de la saisie.
meid

string

Numéro MEID de l'appareil.
Champ d'union hardware_id2. Deuxième ID matériel, pour les appareils à double carte SIM. S'il est défini, il doit avoir le 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 à un 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

L'enregistrement d'un appareil revendiqué par un revendeur pour le compte d'un client. Les appareils revendiqués pour l'inscription sans contact sont associés à une revendication de type SECTION_TYPE_ZERO_TOUCH. Pour en savoir plus, consultez Revendiquer des appareils pour des clients.

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

enum (DeviceProvisioningSectionType)

Uniquement en sortie. Type de revendication effectuée sur l'appareil.
ownerCompanyId

string (int64 format)

Identifiant du client qui a acheté l'appareil.
googleWorkspaceCustomerId

string

ID du compte Google Workspace auquel appartient l'appareil ChromeOS.
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 avec le service de protection des appareils, vous devez vous inscrire auprès de l'équipe chargée des partenariats.

Méthodes

applyConfiguration

 Applique une configuration à l'appareil afin de l'enregistrer pour l'enregistrement sans contact.

get

 Récupère les détails d'un appareil.

list

 Liste les appareils d'un client.

removeConfiguration

 Supprime une configuration de l'appareil.

unclaim

 Reprend un appareil à un client et le supprime de l'enregistrement sans contact.