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 ( |
Champs | |
---|---|
deviceId |
Identifiant unique de l'appareil Chrome. |
serialNumber |
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 |
État de l'appareil. Les valeurs acceptées sont les suivantes :
|
lastSync |
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, plus les heures, les minutes et les secondes, au format |
supportEndDate |
Date à laquelle l'appareil ne sera plus pris en charge. Cela 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, plus les heures, les minutes et les secondes, au format |
annotatedUser |
Utilisateur de l'appareil (annoté par l'administrateur). Il ne doit pas dépasser 100 caractères. Les valeurs vides sont autorisées. |
annotatedLocation |
Adresse ou emplacement de l'appareil (annoté par l'administrateur). Le nom de l'environnement ne peut pas comporter plus de |
notes |
Notes concernant cet appareil ajoutées par l'administrateur. Cette propriété peut être recherchée avec le paramètre |
model |
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 |
Identifiant d'équipement mobile (MEID) ou identifiant international d'équipement mobile (IMEI) de la carte mobile 3G dans 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 de codes MEID/IMEI, consultez le guide du développeur. |
orderNumber |
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 |
Détermine si l'assistance de l'appareil sera automatiquement renouvelée après la date de fin de l'assistance. Il s'agit d'une propriété en lecture seule. |
osVersion |
Version du système d'exploitation de l'appareil Chrome. |
platformVersion |
Version de la plate-forme de l'appareil Chrome. |
firmwareVersion |
Version du micrologiciel de l'appareil Chrome. |
macAddress |
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 |
Mode de démarrage de l'appareil. Les valeurs possibles sont :
|
lastEnrollmentTime |
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, plus les heures, les minutes et les secondes, au format |
kind |
Type de ressource. Pour la ressource Chromeosdevices, la valeur est |
recentUsers[] |
Liste des utilisateurs récents de l'appareil, par ordre décroissant de la date de dernière connexion. |
recentUsers[].type |
Type d'utilisateur. Les valeurs acceptées sont les suivantes :
|
recentUsers[].email |
Adresse e-mail de l'utilisateur. Ce champ n'est présent que si le type d'utilisateur est |
activeTimeRanges[] |
Liste des plages de temps actives (en lecture seule). |
activeTimeRanges[].activeTime |
Durée d'utilisation en millisecondes. |
activeTimeRanges[].date |
Date d'utilisation. |
ethernetMacAddress |
Adresse MAC de l'appareil sur l'interface réseau Ethernet. |
annotatedAssetId |
Identifiant d'élément indiqué par un administrateur ou spécifié lors de l'enregistrement. |
etag |
ETag de la ressource. |
diskVolumeReports[] |
Rapports sur l'espace disque et autres informations sur les volumes associés/connectés. |
diskVolumeReports[].volumeInfo[] |
Volumes de disque |
diskVolumeReports[].volumeInfo[].volumeId |
ID du volume |
diskVolumeReports[].volumeInfo[].storageTotal |
Espace disque total [en octets] |
diskVolumeReports[].volumeInfo[].storageFree |
Espace disque disponible [en octets] |
systemRamTotal |
RAM totale de l'appareil en octets |
cpuStatusReports[] |
Rapports sur l'utilisation et la température du processeur (lecture seule) |
cpuStatusReports[].reportTime |
Date et heure de réception du signalement. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Liste d'échantillons de température du processeur. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Température en degrés Celsius. |
cpuStatusReports[].cpuTemperatureInfo[].label |
Libellé du processeur |
cpuInfo[] |
Informations sur les caractéristiques du processeur de l'appareil. |
cpuInfo[].model |
Nom du modèle de processeur. |
cpuInfo[].architecture |
Architecture du processeur. |
cpuInfo[].maxClockSpeedKhz |
Vitesse d'horloge maximale du processeur en kHz. |
cpuInfo[].logicalCpus[] |
Informations pour les processeurs logiques |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Fréquence maximale à laquelle le processeur est autorisé à fonctionner, selon la règle. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Fréquence actuelle à laquelle le processeur s'exécute. |
cpuInfo[].logicalCpus[].idleDuration |
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 " |
cpuInfo[].logicalCpus[].cStates[] |
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 |
Nom de l'État. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
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 " |
deviceFiles[] |
Liste des fichiers d'appareils à télécharger (en lecture seule) |
deviceFiles[].name |
Nom du fichier |
deviceFiles[].type |
Type de fichier |
deviceFiles[].downloadUrl |
URL de téléchargement du fichier |
deviceFiles[].createTime |
Date et heure de création du fichier |
systemRamFreeReports[] |
Rapports sur la quantité de mémoire vive disponible (lecture seule) |
systemRamFreeReports[].reportTime |
Date et heure de réception du signalement. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
Contient le dernier réseau connu (lecture seule) |
lastKnownNetwork[].ipAddress |
Adresse IP |
lastKnownNetwork[].wanIpAddress |
Adresse IP du réseau étendu |
autoUpdateExpiration |
(Lecture seule) Code temporel après lequel l'appareil ne recevra plus de mises à jour ni d'assistance Chrome. Veuillez utiliser "autoUpdateThrough" à la place. |
ethernetMacAddress0 |
Adresse MAC (en lecture seule) utilisée par le port Ethernet interne du Chromebook et pour l'interface réseau (Ethernet) intégrée. Il s'agit de 12 chiffres hexadécimaux sans délimiteur (lettres majuscules). Cette option ne concerne que certains appareils. |
dockMacAddress |
(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 pour son utilisation. Il est réservé spécifiquement à la règle relative aux périphériques de transfert d'adresse MAC. Il s'agit de 12 chiffres hexadécimaux sans délimiteur (lettres majuscules). Cette option ne concerne que certains appareils. |
manufactureDate |
(Lecture seule) Date de fabrication de l'appareil au format aaaa-mm-jj. |
orgUnitPath |
Chemin d'accès parent complet avec le nom de l'unité organisationnelle associée à l'appareil. Les noms de chemins 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 ( |
tpmVersionInfo |
Trusted Platform Module (TPM) (lecture seule) |
tpmVersionInfo.family |
Famille TPM. Nous utilisons l'encodage de style TPM 2.0, par exemple : |
tpmVersionInfo.specLevel |
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 |
Code du fabricant du module TPM. |
tpmVersionInfo.tpmModel |
Numéro de modèle du TPM. |
tpmVersionInfo.firmwareVersion |
Version du micrologiciel TPM. |
tpmVersionInfo.vendorSpecific |
Informations spécifiques au fournisseur, comme l'ID du fournisseur. |
screenshotFiles[] |
Liste des fichiers de capture d'écran à télécharger. Le type est toujours "SCREENSHOT_FILE". (Lecture seule) |
screenshotFiles[].name |
Nom du fichier |
screenshotFiles[].type |
Type de fichier |
screenshotFiles[].downloadUrl |
URL de téléchargement du fichier |
screenshotFiles[].createTime |
Date et heure de création du fichier |
orgUnitId |
ID unique de l'unité organisationnelle. orgUnitPath est la version lisible par l'utilisateur de orgUnitId. Bien que orgUnitPath puisse changer en renommant une unité organisationnelle dans le chemin d'accès, orgUnitId est immuable 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 |
État des mises à jour de l'OS pour l'appareil. |
firstEnrollmentTime |
Date et heure du premier enregistrement de l'appareil. |
lastDeprovisionTimestamp |
(Lecture seule) Date et heure de la dernière désactivation de l'appareil. |
deprovisionReason |
(Lecture seule) Motif de l'annulation de la gestion. |
deviceLicenseType |
Uniquement en sortie. Type de licence de l'appareil. |
backlightInfo[] |
Uniquement en sortie. Contient des informations sur le rétroéclairage de l'appareil. |
autoUpdateThrough |
Uniquement en sortie. Code temporel après lequel l'appareil ne recevra plus de mises à jour ni d'assistance Chrome. |
extendedSupportEligible |
Uniquement en sortie. Indique si l'appareil nécessite l'activation de la compatibilité étendue. |
extendedSupportStart |
Uniquement en sortie. Date à laquelle la période de compatibilité étendue pour les mises à jour automatiques commence pour l'appareil. |
extendedSupportEnabled |
Uniquement en sortie. Indique si la règle de compatibilité étendue est activée sur l'appareil. |
fanInfo[] |
Uniquement en sortie. Informations sur le ventilateur de l'appareil. |
chromeOsType |
Uniquement en sortie. Type d'appareil ChromeOS. |
diskSpaceUsage |
Uniquement en sortie. Espace disque disponible et actuellement utilisé par l'appareil. |
osVersionCompliance |
Uniquement en sortie. État de conformité de la version de l'OS avec les règles relatives aux appareils. |
OsUpdateStatus
Contient des informations sur l'état actuel de la mise à jour de l'OS.
Représentation JSON |
---|
{
"state": enum ( |
Champs | |
---|---|
state |
État de mise à jour d'une mise à jour de l'OS. |
targetOsVersion |
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 extrêmes, par exemple lorsque le moteur de mise à jour est redémarré sans redémarrage. |
targetKioskAppVersion |
Nouvelle version de plate-forme requise pour l'application kiosk en attente de mise à jour. |
updateTime |
Date et heure de la dernière mise à jour réussie de l'OS. |
updateCheckTime |
Date et heure de la dernière vérification des mises à jour. |
rebootTime |
Date et heure du dernier redémarrage. |
UpdateState
État de mise à jour d'une 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 n'a pas encore 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
Raison 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 ancienne qui n'est plus valable. |
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 |
Retrait 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 |
Aucun motif n'était requis. 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 annuelle Chrome Enterprise Upgrade 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. |
ENTERPRISE_UPGRADE_PERPETUAL |
Indique que l'appareil utilise une licence Chrome Enterprise Upgrade permanente et autonome, ou une licence Chrome Enterprise. |
ENTERPRISE_UPGRADE_FIXED_TERM |
Indique que l'appareil utilise une licence Chrome Enterprise Upgrade autonome à durée déterminée ou une licence Chrome Enterprise. |
EDUCATION_UPGRADE_PERPETUAL |
Indique que l'appareil utilise une licence Chrome Education Upgrade permanente autonome(également appelée licence Chrome EDU permanente). |
EDUCATION_UPGRADE_FIXED_TERM |
Indique que l'appareil utilise une licence Chrome Education Upgrade autonome à durée déterminée(également appelée licence Chrome EDU à durée déterminée). |
BacklightInfo
Informations sur le rétroéclairage de l'appareil.
Représentation JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
Champs | |
---|---|
path |
Uniquement en sortie. Chemin d'accès à ce rétroéclairage sur le système. Utile si l'appelant doit établir une corrélation avec d'autres informations. |
maxBrightness |
Uniquement en sortie. Luminosité maximale du rétroéclairage. |
brightness |
Uniquement en sortie. Luminosité actuelle du rétroéclairage, entre 0 et maxBrightness. |
FanInfo
Informations sur le ventilateur de l'appareil.
Représentation JSON |
---|
{ "speedRpm": integer } |
Champs | |
---|---|
speedRpm |
Uniquement en sortie. Vitesse du ventilateur en tr/min. |
ChromeOsType
Type d'appareil ChromeOS.
Enums | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
Type ChromeOS non spécifié. |
CHROME_OS_FLEX |
Type d'OS 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 |
Uniquement en sortie. Valeur de la capacité totale, en octets. |
usedBytes |
Uniquement en sortie. Valeur d'utilisation actuelle, en octets. |
Conformité
État de conformité de la version de l'OS avec les règles relatives aux appareils.
Enums | |
---|---|
COMPLIANCE_UNSPECIFIED |
État de conformité non spécifié. |
COMPLIANT |
L'état de conformité est "Conforme". |
PENDING |
L'état de conformité est "En attente". |
NOT_COMPLIANT |
L'état de conformité n'est pas conforme. |
Méthodes |
|
---|---|
(deprecated) |
Utilisez plutôt BatchChangeChromeOsDeviceStatus. |
|
Récupère les propriétés d'un appareil ChromeOS. |
|
Récupère une liste paginée des appareils ChromeOS d'un compte. |
|
Déplace ou insère plusieurs appareils ChromeOS dans une unité organisationnelle. |
|
Met à jour les propriétés modifiables d'un appareil, telles que annotatedUser , annotatedLocation , notes , orgUnitPath ou annotatedAssetId . |
|
Met à jour les propriétés modifiables d'un appareil, telles que annotatedUser , annotatedLocation , notes , orgUnitPath ou annotatedAssetId . |