REST Resource: chromeosdevices

Ressource: ChromeOsDevice

Les appareils Google Chrome fonctionnent sous Chrome OS. Pour en savoir plus sur les tâches API courantes, 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),
  "diskSpaceUsage": {
    object (ByteUsage)
  }
}
Champs
deviceId

string

Identifiant unique de l'appareil Chrome.
serialNumber

string

Numéro de série de l'appareil Chrome saisi lors de l'activation de l'appareil. Cette valeur est identique au numéro de série de la console d'administration 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 a expiré et l'appareil ne reçoit plus de règles ni de paramètres. Lorsqu'une nouvelle licence est achetée, l'appareil revient à 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 sur l'appareil. Si l'appareil est réactivé, les derniers paramètres système sont appliqués à cet appareil.
  • 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: une demande de remplacement de cet appareil a été effectuée.
  • 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 de règles entre l'appareil et la console d'administration. La valeur est au format de date et d'heure ISO 8601. L'heure correspond à la date complète, suivie des heures, minutes et secondes au format YYYY-MM-DDThh:mm:ssTZD. Par exemple, 2010-04-05T17:30:04+01:00.
supportEndDate

string

Date à laquelle l'appareil ne sera plus pris en charge. Cette offre ne s'applique qu'aux appareils achetés directement auprès de Google. La valeur est au format de date et d'heure ISO 8601. L'heure correspond à la date complète, suivie des heures, minutes et secondes au format YYYY-MM-DDThh:mm:ssTZD. Par exemple, 2010-04-05T17:30:04+01:00.
annotatedUser

string

Utilisateur de l'appareil (annoté 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 (annoté 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 ajoutées par l'administrateur concernant cet appareil. 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

Code MEID (Mobile Equipment Identifier) ou IMEI (International Mobile Equipment Identity) de la carte mobile 3G d'un appareil mobile. Un MEID/IMEI est généralement utilisé pour ajouter un appareil au forfait avec post-paiement d'un opérateur de téléphonie mobile. Si l'appareil ne dispose pas de ces informations, cette propriété n'est pas incluse dans la réponse. Pour savoir comment exporter 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

Indique si la prise en charge de l'appareil sera automatiquement renouvelée après la date de fin de la prise en charge. Il s'agit d'une propriété 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 ChromeOS.
  • Dev: le commutateur matériel du développeur est activé sur l'appareil. Lors du démarrage, l'appareil dispose d'un shell de ligne de commande. Pour voir un exemple de bouton bascule pour les développeurs, consultez les informations pour les développeurs Chromebook.
lastEnrollmentTime

string

Date et heure du dernier enregistrement de l'appareil. La valeur est au format de date et d'heure ISO 8601. L'heure correspond à la date complète, suivie des heures, minutes et secondes au format YYYY-MM-DDThh:mm:ssTZD. Par exemple, 2010-04-05T17:30:04+01:00. Pour en savoir plus sur l'inscription automatique et manuelle, 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, par ordre décroissant de la date de dernière connexion.
recentUsers[].type

string

Type de l'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. Ce champ 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 (annoté par un administrateur ou spécifié lors de l'enregistrement).
etag

string

ETag de la ressource.
diskVolumeReports[]

object

Rapports sur l'espace disque et 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)

Mémoire RAM totale de l'appareil en octets
cpuStatusReports[]

object

Rapports sur l'utilisation et la température du processeur (lecture seule)
cpuStatusReports[].reportTime

string

Date et heure de réception du rapport.
cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer
cpuStatusReports[].cpuTemperatureInfo[]

object

Liste d'exemples de températures du processeur.
cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Température en degrés Celsius.
cpuStatusReports[].cpuTemperatureInfo[].label

string

Libellé du processeur
cpuInfo[]

object

Informations sur les spécifications du processeur de l'appareil.
cpuInfo[].model

string

Nom du modèle de processeur.
cpuInfo[].architecture

string

Architecture du processeur.
cpuInfo[].maxClockSpeedKhz

integer

Vitesse d'horloge maximale du processeur en kHz.
cpuInfo[].logicalCpus[]

object

Informations sur les processeurs logiques
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Fréquence maximale à laquelle le processeur est autorisé à s'exécuter, conformément aux règles.
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Fréquence actuelle à laquelle le processeur s'exécute.
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 processeur. 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 cet é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 d'appareils à télécharger (en lecture seule)
deviceFiles[].name

string

Nom du fichier
deviceFiles[].type

string

File type
deviceFiles[].downloadUrl

string

URL de téléchargement du fichier
deviceFiles[].createTime

string

Date et heure de création du fichier
systemRamFreeReports[]

object

Rapports sur la quantité 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

L'adresse IP
lastKnownNetwork[].wanIpAddress

string

Adresse IP du réseau étendu.
autoUpdateExpiration
(deprecated)

string (int64 format)

(Lecture seule) Code temporel à partir duquel l'appareil ne recevra plus de mises à jour ni d'assistance Chrome. Veuillez utiliser "autoUpdateThrough" à la place.
ethernetMacAddress0

string

(Lecture seule) Adresse MAC utilisée par le port Ethernet interne du Chromebook et par l'interface réseau (Ethernet) intégrée. Le format est composé de 12 chiffres hexadécimaux sans séparateur (lettres majuscules). Cette option n'est disponible que sur certains appareils.
dockMacAddress

string

(Lecture seule) Adresse MAC intégrée de la station d'accueil à laquelle l'appareil est connecté. Définit l'adresse MAC (Media Access Control) attribuée à une station d'accueil. Il est réservé spécifiquement à la stratégie d'appareil de passthrough MAC. Le format est composé de 12 chiffres hexadécimaux sans séparateur (lettres majuscules). Cette option n'est disponible que sur 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 chemins 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 pour les administrateurs.
tpmVersionInfo

object

Trusted Platform Module (TPM) (lecture seule)
tpmVersionInfo.family

string

Famille 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. Consultez la spécification de bibliothèque pour TPM 2.0 et la spécification principale pour TPM 1.2.
tpmVersionInfo.manufacturer

string

Code du 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 l'ID du fournisseur
screenshotFiles[]

object

Liste des fichiers de capture 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 du fichier
screenshotFiles[].createTime

string

Date et heure de création du fichier
orgUnitId

string

Identifiant unique de l'unité organisationnelle. orgUnitPath est la version lisible par l'humain d'orgUnitId. Bien que orgUnitPath puisse changer en renommant une unité organisationnelle dans le chemin d'accès, orgUnitId ne peut pas être modifié pour une 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 pour les administrateurs.
osUpdateStatus

object (OsUpdateStatus)

État des mises à jour du système d'exploitation de l'appareil.
firstEnrollmentTime

string

Date et heure du premier enregistrement de l'appareil.
lastDeprovisionTimestamp

string

(Lecture seule) Date et heure de la dernière désactivation de l'appareil.
deprovisionReason

enum (DeprovisionReason)

(Lecture seule) Raison de l'annulation de la gestion.
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 à partir duquel l'appareil ne recevra plus de mises à jour ni d'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 l'appareil au début de la période de prise en charge étendue pour les mises à jour automatiques.
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.
diskSpaceUsage

object (ByteUsage)

Uniquement en sortie. Espace disque disponible et utilisé par 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 d'un système d'exploitation.
targetOsVersion

string

Nouvelle version de la plate-forme de l'image de l'OS téléchargée et appliquée. 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 particuliers, par exemple lorsque le moteur de mise à jour est redémarré sans redémarrage.
targetKioskAppVersion

string

Nouvelle version de plate-forme requise de l'application Kiosk mise à jour en attente.
updateTime

string

Date et heure de la dernière mise à jour du système d'exploitation réussie.
updateCheckTime

string

Date et heure de la dernière vérification de la mise à jour.
rebootTime

string

Date et heure du dernier redémarrage.

UpdateState

État de la mise à jour d'un système d'exploitation.

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 commencé.
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 de la désactivation 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

L'appareil a été déprovisionné pour une raison obsolète qui n'est plus prise en charge.
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT Remplacement par un modèle différent. Vous remplacez l'appareil par un modèle plus récent.
DEPROVISION_REASON_RETIRING_DEVICE Retiré du parc. Vous donnez, jetez ou mettez au rebut l'appareil.
DEPROVISION_REASON_UPGRADE_TRANSFER Transfert de licence ChromeOS Flex. Il s'agit d'un appareil ChromeOS Flex que vous remplacez par un Chromebook sous un an.
DEPROVISION_REASON_NOT_REQUIRED Vous n'avez pas à indiquer de motif. Par exemple, les licences ont été renvoyées au pool de licences du client.
DEPROVISION_REASON_REPAIR_CENTER L'appareil a été déprovisionné par le centre de réparation. 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 Chrome Enterprise Upgrade permanente.
ENTERPRISE_UPGRADE L'appareil dispose d'une licence Chrome Enterprise Upgrade annuelle autonome.
EDUCATION_UPGRADE L'appareil dispose d'une licence Chrome Education Upgrade autonome et 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 dans le système. Utile si l'appelant doit établir 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 maxBrightness.

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 ChromeOS : saisissez ChromeOS Flex.
CHROME_OS ChromeOS Saisissez ChromeOS.

ByteUsage

Représente une capacité de données avec une certaine quantité d'utilisation actuelle en octets.

Représentation JSON 
{
  "capacityBytes": string,
  "usedBytes": string
}
Champs
capacityBytes

string (int64 format)

Uniquement en sortie. Valeur de la capacité totale, en octets.
usedBytes

string (int64 format)

Uniquement en sortie. Valeur d'utilisation actuelle, en octets.

Méthodes

action
(deprecated)

 Utilisez plutôt BatchChangeChromeOsDeviceStatus.

get

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

list

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

moveDevicesToOu

 Déplace ou insère plusieurs appareils ChromeOS dans une unité organisationnelle.

patch

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

update

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