REST Resource: customers.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)
    }
  ],
  "configuration": string
}
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 la ressource API au format customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Attribué par le serveur.
deviceMetadata

object (DeviceMetadata)

Métadonnées associées à l'appareil. Structure en paires clé-valeur.
claims[]

object (DeviceClaim)

Uniquement en sortie. Revendications de provisionnement pour un appareil. Les appareils revendiqués pour l'inscription sans contact font l'objet d'une revendication de type SECTION_TYPE_ZERO_TOUCH. Appelez customers.devices.unclaim pour supprimer 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 le matériel et les ID produit pour identifier un appareil fabriqué. Pour comprendre les exigences liées aux ensembles d'identifiants, consultez la section 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.
}
Champs
serialNumber

string

Numéro de série du fabricant de l'appareil. Cette valeur peut ne pas être unique sur 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 indiquées sur la page Fabricants Android.
model

string

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

enum (DeviceType)

Type d'appareil
chromeOsAttestedDeviceId

string

Identifiant fourni par les OEM lors du processus de production et de vente. Applicable uniquement aux appareils Chrome OS.
Champ d'union hardware_id. ID matériel basé sur un ID de modem. hardware_id ne peut être qu'un des éléments suivants :
imei

string

Numéro IMEI de l'appareil. Validé à l'entrée.
meid

string

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 Chrome OS

Métadonnées de l'appareil

Entrées de métadonnées pouvant être associées à un Device. Pour en savoir plus, consultez Métadonnées des appareils.

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

map (key: string, value: string)

Entrées de métadonnées enregistrées en tant que paires clé-valeur.

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

Revendication d'appareil

Enregistrement d'un appareil revendiqué par un revendeur pour un client. Les appareils revendiqués pour l'inscription sans contact font l'objet d'une revendication de type SECTION_TYPE_ZERO_TOUCH. Pour en savoir plus, consultez Revendiquer des appareils pour les 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)

ID du Client qui a acheté l'appareil Android.
googleWorkspaceCustomerId

string

ID du compte Google Workspace auquel appartient l'appareil Chrome OS.
additionalService

enum (AdditionalService)

Service supplémentaire enregistré pour l'appareil.

Type de section de gestion des appareils

Type de section d'un enregistrement de provisionnement.

Enums
SECTION_TYPE_SIM_LOCK Type de section de verrouillage de la carte SIM.
SECTION_TYPE_ZERO_TOUCH Type de section d'inscription sans contact.

Service complémentaire

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 responsable des partenariats.

Méthodes

applyConfiguration

 Applique une configuration à l'appareil pour l'inscrire à l'inscription 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

 Retirer l'appareil d'un client et le retirer de l'inscription sans contact