REST Resource: chromeosdevices

Ressource: ChromeOsDevice

Les appareils Google Chrome fonctionnent sous Chrome OS. Pour en savoir plus sur les tâches courantes de l'API, consultez le guide du développeur.

Représentation JSON
{
  "deviceId": string,
  "serialNumber": string,
  "status": string,
  "lastSync": string,
  "supportEndDate": string,
  "annotatedUser": string,
  "annotatedLocation": string,
  "notes": string,
  "model": string,
  "meid": string,
  "orderNumber": string,
  "willAutoRenew": boolean,
  "osVersion": string,
  "platformVersion": string,
  "firmwareVersion": string,
  "macAddress": string,
  "bootMode": string,
  "lastEnrollmentTime": string,
  "kind": string,
  "recentUsers": [
    {
      "type": string,
      "email": string
    }
  ],
  "activeTimeRanges": [
    {
      "activeTime": integer,
      "date": string
    }
  ],
  "ethernetMacAddress": string,
  "annotatedAssetId": string,
  "etag": string,
  "diskVolumeReports": [
    {
      "volumeInfo": [
        {
          "volumeId": string,
          "storageTotal": string,
          "storageFree": string
        }
      ]
    }
  ],
  "systemRamTotal": string,
  "cpuStatusReports": [
    {
      "reportTime": string,
      "cpuUtilizationPercentageInfo": [
        integer
      ],
      "cpuTemperatureInfo": [
        {
          "temperature": integer,
          "label": string
        }
      ]
    }
  ],
  "cpuInfo": [
    {
      "model": string,
      "architecture": string,
      "maxClockSpeedKhz": integer,
      "logicalCpus": [
        {
          "maxScalingFrequencyKhz": integer,
          "currentScalingFrequencyKhz": integer,
          "idleDuration": string,
          "cStates": [
            {
              "displayName": string,
              "sessionDuration": string
            }
          ]
        }
      ]
    }
  ],
  "deviceFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "systemRamFreeReports": [
    {
      "reportTime": string,
      "systemRamFreeInfo": [
        string
      ]
    }
  ],
  "lastKnownNetwork": [
    {
      "ipAddress": string,
      "wanIpAddress": string
    }
  ],
  "autoUpdateExpiration": string,
  "ethernetMacAddress0": string,
  "dockMacAddress": string,
  "manufactureDate": string,
  "orgUnitPath": string,
  "tpmVersionInfo": {
    "family": string,
    "specLevel": string,
    "manufacturer": string,
    "tpmModel": string,
    "firmwareVersion": string,
    "vendorSpecific": string
  },
  "screenshotFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "orgUnitId": string,
  "osUpdateStatus": {
    object (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType)
}
Champs
deviceId

string

Identifiant unique de l'appareil Chrome.

serialNumber

string

Numéro de série de l'appareil Chrome saisi lors de son activation. Cette valeur est identique au numéro de série de la console d'administration, qui figure dans l'onglet Appareils ChromeOS.

status

string

État de l'appareil.

Les valeurs acceptées sont les suivantes :

  • ACTIVE: l'appareil est enregistré dans le domaine.
  • DELINQUENT: la licence annuelle du domaine est arrivée à expiration, et l'appareil ne reçoit plus de règles ni de paramètres. Lorsqu'une nouvelle licence est achetée, l'appareil repasse à l'état ACTIVE.
  • PRE_PROVISIONED: l'appareil a été enregistré pour l'enregistrement sans contact. Un appareil PRE_PROVISIONED peut être déplacé vers une autre unité organisationnelle ou supprimé. Une fois l'enregistrement terminé, l'appareil sera ACTIVE.
  • DEPROVISIONED: l'appareil ne peut plus être enregistré dans le domaine. La commande a été annulée. Les paramètres de l'appareil ont été mis en cache. Si l'appareil est réactivé à nouveau, les derniers paramètres système lui sont appliqués.
  • DISABLED: l'appareil a été désactivé par l'administrateur et ne peut pas être utilisé.
  • INACTIVE: l'appareil n'est pas enregistré dans le domaine.
  • RETURN_ARRIVED: la demande de remplacement de cet appareil est arrivée.
  • RETURN_REQUESTED: le remplacement de cet appareil a été demandé.
  • SHIPPED: l'appareil est expédié depuis l'inventaire Google. (Obsolète)
  • UNKNOWN: l'état de l'appareil ne peut pas être déterminé.
lastSync

string

Date et heure de la dernière synchronisation des paramètres des règles entre l'appareil et la console d'administration. La date et l'heure sont au format ISO 8601. L'heure correspond à la date complète suivie des heures, des minutes et des secondes, au format YYYY-MM-DDThh:mm:ssTZD. Exemple : 2010-04-05T17:30:04+01:00.

supportEndDate

string

Date limite de prise en charge de l'appareil. Cela ne s'applique qu'aux appareils achetés directement auprès de Google. La date et l'heure sont au format ISO 8601. L'heure correspond à la date complète suivie des heures, des minutes et des secondes, au format YYYY-MM-DDThh:mm:ssTZD. Exemple : 2010-04-05T17:30:04+01:00.

annotatedUser

string

Utilisateur de l'appareil, comme indiqué par l'administrateur. Il ne doit pas dépasser 100 caractères. Les valeurs vides sont autorisées.

annotatedLocation

string

Adresse ou emplacement de l'appareil, tel qu'indiqué par l'administrateur. Le nom de l'environnement ne peut pas comporter plus de 200 caractères. Les valeurs vides sont autorisées.

notes

string

Notes concernant cet appareil ajoutées par l'administrateur. Vous pouvez effectuer une recherche dans cette propriété à l'aide du paramètre query de la méthode list. Ne doit pas dépasser 500 caractères Les valeurs vides sont autorisées.

model

string

Informations sur le modèle de l'appareil. Si l'appareil ne dispose pas de ces informations, cette propriété n'est pas incluse dans la réponse.

meid

string

Identifiant MEID ou Code IMEI (International Mobile Equipment Identity) de la carte mobile 3G d'un appareil mobile. Le code MEID/IMEI est généralement utilisé lors de l'ajout d'un appareil au forfait avec post-paiement d'un opérateur mobile. Si l'appareil ne dispose pas de ces informations, cette propriété n'est pas incluse dans la réponse. Pour plus d'informations sur l'exportation d'une liste MEID/IMEI, consultez le Guide du développeur.

orderNumber

string

Numéro de commande de l'appareil. Seuls les appareils achetés directement auprès de Google disposent d'un numéro de commande.

willAutoRenew

boolean

Détermine si l'appareil renouvellera automatiquement sa prise en charge après la date de fin de la prise en charge. Cette propriété est en lecture seule.

osVersion

string

Version du système d'exploitation de l'appareil Chrome.

platformVersion

string

Version de la plate-forme de l'appareil Chrome.

firmwareVersion

string

Version du micrologiciel de l'appareil Chrome.

macAddress

string

Adresse MAC sans fil de l'appareil. Si l'appareil ne dispose pas de ces informations, elles ne sont pas incluses dans la réponse.

bootMode

string

Mode de démarrage de l'appareil. Les valeurs possibles sont :

  • Verified: l'appareil exécute une version valide de Chrome OS.
  • Dev: le bouton bascule matériel pour les développeurs de l'appareil est activé. Lors du démarrage, l'appareil dispose d'une interface système de ligne de commande. Pour obtenir un exemple de switch de développeur, consultez les informations destinées aux développeurs Chromebook.
lastEnrollmentTime

string

Date et heure du dernier enregistrement de l'appareil. La date et l'heure sont au format ISO 8601. L'heure correspond à la date complète suivie des heures, des minutes et des secondes, au format YYYY-MM-DDThh:mm:ssTZD. Exemple : 2010-04-05T17:30:04+01:00. Pour en savoir plus sur l'enregistrement automatique et manuel, consultez le Centre d'aide Chrome.

kind

string

Type de ressource. Pour la ressource Chromeosdevices, la valeur est admin#directory#chromeosdevice.

recentUsers[]

object

Liste des utilisateurs récents de l'appareil, classés par ordre décroissant en fonction de l'heure de leur dernière connexion.

recentUsers[].type

string

Type d'utilisateur.

Les valeurs acceptées sont les suivantes :

  • USER_TYPE_MANAGED: l'utilisateur est géré par le domaine.
  • USER_TYPE_UNMANAGED: l'utilisateur n'est pas géré par le domaine.
recentUsers[].email

string

Adresse e-mail de l'utilisateur. Cet élément n'est présent que si le type d'utilisateur est USER_TYPE_MANAGED.

activeTimeRanges[]

object

Liste des périodes actives (lecture seule).

activeTimeRanges[].activeTime

integer

Durée d'utilisation en millisecondes.

activeTimeRanges[].date

string

Date d'utilisation.

ethernetMacAddress

string

Adresse MAC de l'appareil sur l'interface réseau Ethernet.

annotatedAssetId

string

Identifiant d'élément noté par un administrateur ou spécifié lors de l'inscription.

etag

string

ETag de la ressource.

diskVolumeReports[]

object

Rapports sur l'espace disque et d'autres informations sur les volumes installés/connectés

diskVolumeReports[].volumeInfo[]

object

Volumes de disque

diskVolumeReports[].volumeInfo[].volumeId

string

ID du volume

diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

Espace disque total [en octets]

diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

Espace disque disponible [en octets]

systemRamTotal

string (int64 format)

RAM totale sur l'appareil en octets

cpuStatusReports[]

object

Rapports sur l'utilisation du processeur et la température (lecture seule)

cpuStatusReports[].reportTime

string

Date et heure de réception du rapport.

cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer

cpuStatusReports[].cpuTemperatureInfo[]

object

Liste d'échantillons de température du processeur.

cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Température en degrés Celsius.

cpuStatusReports[].cpuTemperatureInfo[].label

string

Étiquette du processeur

cpuInfo[]

object

Informations concernant les caractéristiques du processeur de l'appareil.

cpuInfo[].model

string

Nom du modèle du processeur.

cpuInfo[].architecture

string

Architecture du processeur

cpuInfo[].maxClockSpeedKhz

integer

Vitesse d'horloge maximale du processeur en kHz.

cpuInfo[].logicalCpus[]

object

Informations pour les processeurs logiques

cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Fréquence maximale à laquelle le processeur est autorisé à s'exécuter, par règle.

cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Fréquence actuelle à laquelle le processeur est exécuté.

cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Temps d'inactivité depuis le dernier démarrage.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

cpuInfo[].logicalCpus[].cStates[]

object

Les C-States indiquent l'état de consommation d'énergie du CPU. Pour en savoir plus, consultez la documentation publiée par le fabricant du processeur.

cpuInfo[].logicalCpus[].cStates[].displayName

string

Nom de l'État.

cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

Temps passé dans l'état depuis le dernier redémarrage.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

deviceFiles[]

object

Liste des fichiers de l'appareil à télécharger (lecture seule)

deviceFiles[].name

string

Nom du fichier

deviceFiles[].type

string

File type

deviceFiles[].downloadUrl

string

URL de téléchargement de fichier

deviceFiles[].createTime

string

Date et heure de création du fichier

systemRamFreeReports[]

object

Rapports sur les quantités de mémoire RAM disponible (lecture seule)

systemRamFreeReports[].reportTime

string

Date et heure de réception du rapport.

systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)

lastKnownNetwork[]

object

Contient le dernier réseau connu (lecture seule)

lastKnownNetwork[].ipAddress

string

Adresse IP.

lastKnownNetwork[].wanIpAddress

string

Adresse IP du WAN.

autoUpdateExpiration
(deprecated)

string (int64 format)

(Lecture seule) Horodatage après lequel l'appareil cessera de recevoir les mises à jour ou l'assistance de Chrome. Veuillez utiliser "autoUpdateThrough" à la place.

ethernetMacAddress0

string

Adresse MAC (en lecture seule) utilisée par le port Ethernet interne du Chromebook et pour l'interface réseau intégrée (Ethernet). Le format est composé de douze (12) chiffres hexadécimaux sans délimiteur (lettres majuscules). Cela ne concerne que certains appareils.

dockMacAddress

string

(Lecture seule) Adresse MAC intégrée de la station d'accueil à laquelle l'appareil s'est connecté. La configuration d'usine définit l'adresse MAC (Media Access Control) attribuée pour être utilisée par une station d'accueil. Elle est réservée spécifiquement à l'authentification MAC Pass-through Device Policy. Le format est composé de douze (12) chiffres hexadécimaux sans délimiteur (lettres majuscules). Cela ne concerne que certains appareils.

manufactureDate

string

(Lecture seule) Date de fabrication de l'appareil, au format "aaaa-mm-jj".

orgUnitPath

string

Chemin d'accès parent complet avec le nom de l'unité organisationnelle associée à l'appareil. Les noms de chemin d'accès ne sont pas sensibles à la casse. Si l'unité organisationnelle parente est l'organisation racine, elle est représentée par une barre oblique, /. Cette propriété peut être mise à jour à l'aide de l'API. Pour savoir comment créer une structure organisationnelle pour votre appareil, consultez le Centre d'aide Administrateur.

tpmVersionInfo

object

TPM (Trusted Platform Module) (lecture seule)

tpmVersionInfo.family

string

TPM. Nous utilisons l'encodage de style TPM 2.0, par exemple :
TPM 1.2 : "1.2" -> 312e3200
TPM 2.0 : "2.0" -> 322E3000

tpmVersionInfo.specLevel

string

Niveau de spécification du TPM. Reportez-vous à la spécification de bibliothèque pour TPM 2.0 et à la spécification principale pour TPM 1.2.

tpmVersionInfo.manufacturer

string

Code fabricant du TPM.

tpmVersionInfo.tpmModel

string

Numéro de modèle du TPM.

tpmVersionInfo.firmwareVersion

string

Version du micrologiciel TPM.

tpmVersionInfo.vendorSpecific

string

Informations spécifiques au fournisseur, telles que son ID.

screenshotFiles[]

object

Liste des fichiers de captures d'écran à télécharger. Le type est toujours "SCREENSHOT_FILE". (Lecture seule)

screenshotFiles[].name

string

Nom du fichier

screenshotFiles[].type

string

File type

screenshotFiles[].downloadUrl

string

URL de téléchargement de fichier

screenshotFiles[].createTime

string

Date et heure de création du fichier

orgUnitId

string

ID unique de l'unité organisationnelle. orgUnitPath est la version lisible de orgUnitId. Bien qu'orgUnitPath puisse changer en renommant une unité organisationnelle dans le chemin, orgUnitId ne peut pas être modifié pour une seule unité organisationnelle. Cette propriété peut être mise à jour à l'aide de l'API. Pour savoir comment créer une structure organisationnelle pour votre appareil, consultez le Centre d'aide Administrateur.

osUpdateStatus

object (OsUpdateStatus)

État des mises à jour de l'OS de l'appareil.

firstEnrollmentTime

string

Date et heure du premier enregistrement de l'appareil.

lastDeprovisionTimestamp

string

(Lecture seule) Date et heure du dernier déprovisionnement de l'appareil.

deprovisionReason

enum (DeprovisionReason)

(Lecture seule) Motif du déprovisionnement.

deviceLicenseType

enum (DeviceLicenseType)

Uniquement en sortie. Type de licence de l'appareil.

backlightInfo[]

object (BacklightInfo)

Uniquement en sortie. Contient des informations sur le rétroéclairage de l'appareil.

autoUpdateThrough

string

Uniquement en sortie. Code temporel après lequel l'appareil ne recevra plus les mises à jour ni l'assistance Chrome.

extendedSupportEligible

boolean

Uniquement en sortie. Indique si l'appareil nécessite l'activation de la compatibilité étendue.

extendedSupportStart

string

Uniquement en sortie. Date de début de la règle de compatibilité étendue pour les mises à jour automatiques sur l'appareil.

extendedSupportEnabled

boolean

Uniquement en sortie. Indique si la règle de compatibilité étendue est activée sur l'appareil.

fanInfo[]

object (FanInfo)

Uniquement en sortie. Informations sur le ventilateur de l'appareil.

chromeOsType

enum (ChromeOsType)

Uniquement en sortie. Type de Chrome OS de l'appareil.

OsUpdateStatus

Contient des informations sur l'état actuel de la mise à jour de l'OS.

Représentation JSON
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Champs
state

enum (UpdateState)

État de la mise à jour de l'OS.

targetOsVersion

string

Nouvelle version de plate-forme de l'image de l'OS en cours de téléchargement et d'application. Il n'est défini que lorsque l'état de la mise à jour est UPDATE_STATUS_DOWNLOAD_IN_PROGRESS ou UPDATE_STATUS_NEED_REBOOT. Notez qu'il peut s'agir d'un "0.0.0.0" factice pour UPDATE_STATUS_NEED_REBOOT dans certains cas limites, par exemple Update Engine redémarre sans redémarrage.

targetKioskAppVersion

string

Nouvelle version de plate-forme requise à partir de l'application kiosque mise à jour.

updateTime

string

Date et heure de la dernière mise à jour réussie de l'OS.

updateCheckTime

string

Date et heure de la dernière recherche de mises à jour.

rebootTime

string

Date et heure du dernier redémarrage.

UpdateState

État de la mise à jour de l'OS.

Enums
UPDATE_STATE_UNSPECIFIED L'état de la mise à jour n'est pas spécifié.
UPDATE_STATE_NOT_STARTED Une mise à jour est en attente, mais elle n'a pas démarré.
UPDATE_STATE_DOWNLOAD_IN_PROGRESS La mise à jour en attente est en cours de téléchargement.
UPDATE_STATE_NEED_REBOOT L'appareil est prêt à installer la mise à jour, mais doit redémarrer.

DeprovisionReason

Motif du déprovisionnement d'un appareil ChromeOS.

Enums
DEPROVISION_REASON_UNSPECIFIED Le motif du déprovisionnement est inconnu.
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT Remplacement par un modèle identique. Vous disposez d'une autorisation de retour de la marchandise (ARM) ou vous remplacez un appareil défectueux sous garantie par le même modèle.
DEPROVISION_REASON_UPGRADE

L'appareil a été mis à niveau.

DEPROVISION_REASON_DOMAIN_MOVE

Le domaine de l'appareil a été modifié.

DEPROVISION_REASON_SERVICE_EXPIRATION

Le service a expiré pour l'appareil.

DEPROVISION_REASON_OTHER

La gestion de l'appareil a été annulée pour une raison ancienne qui n'est plus prise en charge.

DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT Remplacement par un modèle différent. Vous remplacez cet appareil par un modèle plus récent.
DEPROVISION_REASON_RETIRING_DEVICE Retrait du parc. Vous donnez, jetez ou mettez au rebut l'appareil.
DEPROVISION_REASON_UPGRADE_TRANSFER Transfert de la licence ChromeOS Flex. Il s'agit d'un appareil ChromeOS Flex que vous remplacez par un Chromebook sous un an.
DEPROVISION_REASON_NOT_REQUIRED Aucun motif n'était requis. Par exemple, les licences ont été rétablies dans le pool de licences du client.
DEPROVISION_REASON_REPAIR_CENTER Le centre de réparation a déprovisionné l'appareil. Ne peut être défini que par le centre de réparation lors de l'ARM.

DeviceLicenseType

Type de licence de cet appareil.

Enums
DEVICE_LICENSE_TYPE_UNSPECIFIED Le type de licence est inconnu.
ENTERPRISE L'appareil est fourni avec une licence permanente Chrome Enterprise Upgrade.
ENTERPRISE_UPGRADE L'appareil dispose d'une licence Chrome Enterprise Upgrade autonome annuelle.
EDUCATION_UPGRADE L'appareil dispose d'une licence Chrome Education Upgrade autonome, qui est permanente.
EDUCATION L'appareil est fourni avec une licence Chrome Education Upgrade permanente.
KIOSK_UPGRADE L'appareil dispose d'une licence Kiosk Upgrade annuelle.

BacklightInfo

Informations sur le rétroéclairage de l'appareil.

Représentation JSON
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
Champs
path

string

Uniquement en sortie. Chemin d'accès à ce rétroéclairage du système. Utile si l'appelant a besoin d'une corrélation avec d'autres informations.

maxBrightness

integer

Uniquement en sortie. Luminosité maximale du rétroéclairage.

brightness

integer

Uniquement en sortie. Luminosité actuelle du rétroéclairage, comprise entre 0 et la luminosité maximale.

FanInfo

Informations sur le ventilateur de l'appareil.

Représentation JSON
{
  "speedRpm": integer
}
Champs
speedRpm

integer

Uniquement en sortie. Vitesse du ventilateur en tr/min.

ChromeOsType

Type de Chrome OS de l'appareil.

Enums
CHROME_OS_TYPE_UNSPECIFIED Type de ChromeOS non spécifié.
CHROME_OS_FLEX Type de ChromeOS : ChromeOS Flex
CHROME_OS Type de système d'exploitation ChromeOS

Méthodes

action
(deprecated)

Utilisez BatchChangeChromeOsDeviceStatus à la place.

get

Récupère les propriétés d'un appareil Chrome OS.

list

Récupère une liste paginée des appareils Chrome OS au sein d'un compte.

moveDevicesToOu

Déplace ou insère plusieurs appareils Chrome OS vers une unité organisationnelle.

patch

Met à jour les propriétés pouvant être mises à jour d'un appareil, telles que annotatedUser, annotatedLocation, notes, orgUnitPath ou annotatedAssetId.

update

Met à jour les propriétés pouvant être mises à jour d'un appareil, telles que annotatedUser, annotatedLocation, notes, orgUnitPath ou annotatedAssetId.