REST Resource: partners.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)
    }
  ]
}
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 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é 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 dans le cadre de l'enregistrement sans contact sont soumis à une revendication de type SECTION_TYPE_ZERO_TOUCH. Appelez partners.devices.unclaim ou partners.devices.unclaimAsync pour retirer l'appareil de l'enregistrement sans contact.

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,
  "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)

Identifiant du client qui a acheté l'appareil.

googleWorkspaceCustomerId

string

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

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

claim

Revendiquer un appareil pour un client et l'ajouter à l'enregistrement sans contact

claimAsync

Revendication d'un lot d'appareils pour un client de manière asynchrone.

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

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

unclaimAsync

Supprime un lot d'appareils pour un client de manière asynchrone.

updateMetadataAsync

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