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é sous forme de paires clé-valeur.

claims[]

object (DeviceClaim)

Uniquement en sortie. Revendications de provisionnement d'un appareil. Les appareils revendiqués dans le cadre de l'enregistrement sans contact sont soumis à une revendication de type SECTION_TYPE_ZERO_TOUCH. Appelez customers.devices.unclaim pour supprimer l'appareil de l'enregistrement 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 afin d'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.
}
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 répertoriées sur la page des 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 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. ID 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.

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 dans le cadre de l'enregistrement sans contact sont soumis à 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 réclamation déposée sur l'appareil.

ownerCompanyId

string (int64 format)

Identifiant du client ayant acheté l'appareil Android.

googleWorkspaceCustomerId

string

ID du compte Google Workspace propriétaire de l'appareil Chrome OS.

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 de verrouillage de 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

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.