Ресурс: ChromeOsDevice
Устройства Google Chrome работают под управлением Chrome OS . Дополнительную информацию о распространенных задачах API см. в Руководстве разработчика .
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 ( |
Поля | |
---|---|
deviceId | Уникальный идентификатор устройства Chrome. |
serialNumber | Серийный номер устройства Chrome, введенный при включении устройства. Это значение совпадает с серийным номером консоли администратора на вкладке «Устройства Chrome OS» . |
status | Статус устройства. Приемлемые значения:
|
lastSync | Дата и время последней синхронизации устройства с настройками политики в консоли администратора. Значение имеет формат даты и времени ISO 8601 . Время представляет собой полную дату плюс часы, минуты и секунды в формате |
supportEndDate | Окончательная дата, когда устройство будет поддерживаться. Это применимо только к устройствам, приобретенным непосредственно у Google. Значение имеет формат даты и времени ISO 8601 . Время представляет собой полную дату плюс часы, минуты и секунды в формате |
annotatedUser | Пользователь устройства, отмеченный администратором. Максимальная длина — 100 символов. Допускаются пустые значения. |
annotatedLocation | Адрес или местоположение устройства, указанное администратором. Максимальная длина — |
notes | Заметки об этом устройстве добавлены администратором. Это свойство можно найти с помощью параметра |
model | Информация о модели устройства. Если устройство не имеет этой информации, это свойство не включается в ответ. |
meid | Идентификатор мобильного оборудования (MEID) или международный идентификатор мобильного оборудования (IMEI) для мобильной карты 3G в мобильном устройстве. MEID/IMEI обычно используется при добавлении устройства в план обслуживания с постоплатой оператора беспроводной связи. Если устройство не имеет этой информации, это свойство не включается в ответ. Дополнительную информацию о том, как экспортировать список MEID/IMEI, см. в Руководстве разработчика . |
orderNumber | Заказной номер устройства. Только устройства, приобретенные напрямую у Google, имеют номер заказа. |
willAutoRenew | Определяет, будет ли устройство автоматически продлевать поддержку после даты окончания поддержки. Это свойство доступно только для чтения. |
osVersion | Версия операционной системы устройства Chrome. |
platformVersion | Версия платформы устройства Chrome. |
firmwareVersion | Версия прошивки устройства Chrome. |
macAddress | MAC-адрес беспроводной сети устройства. Если устройство не имеет этой информации, она не включается в ответ. |
bootMode | Режим загрузки устройства. Возможные значения:
|
lastEnrollmentTime | Дата и время последней регистрации устройства. Значение имеет формат даты и времени ISO 8601 . Время представляет собой полную дату плюс часы, минуты и секунды в формате |
kind | Тип ресурса. Для ресурса Chromeosdevices используется значение |
recentUsers[] | Список последних пользователей устройства в порядке убывания по времени последнего входа в систему. |
recentUsers[].type | Тип пользователя. Приемлемые значения:
|
recentUsers[].email | Адрес электронной почты пользователя. Это присутствует только в том случае, если тип пользователя — |
activeTimeRanges[] | Список активных временных диапазонов (только чтение). |
activeTimeRanges[].activeTime | Продолжительность использования в миллисекундах. |
activeTimeRanges[].date | Дата использования. |
ethernetMacAddress | MAC-адрес устройства на сетевом интерфейсе Ethernet. |
annotatedAssetId | Идентификатор актива, указанный администратором или указанный при регистрации. |
etag | ETag ресурса. |
diskVolumeReports[] | Отчеты о дисковом пространстве и другая информация о смонтированных/подключенных томах. |
diskVolumeReports[].volumeInfo[] | Дисковые тома |
diskVolumeReports[].volumeInfo[].volumeId | Идентификатор тома |
diskVolumeReports[].volumeInfo[].storageTotal | Общий объем дискового пространства [в байтах] |
diskVolumeReports[].volumeInfo[].storageFree | Свободное место на диске [в байтах] |
systemRamTotal | Общий объем оперативной памяти на устройстве в байтах |
cpuStatusReports[] | Отчеты об использовании и температуре процессора (только чтение) |
cpuStatusReports[].reportTime | Дата и время получения отчета. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] | |
cpuStatusReports[].cpuTemperatureInfo[] | Список образцов температуры процессора. |
cpuStatusReports[].cpuTemperatureInfo[].temperature | Температура в градусах Цельсия. |
cpuStatusReports[].cpuTemperatureInfo[].label | Этикетка процессора |
cpuInfo[] | Информация о характеристиках процессора устройства. |
cpuInfo[].model | Название модели ЦП. |
cpuInfo[].architecture | Архитектура процессора. |
cpuInfo[].maxClockSpeedKhz | Максимальная тактовая частота процессора в кГц. |
cpuInfo[].logicalCpus[] | Информация для логических процессоров |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz | Максимальная частота, на которой процессор может работать в соответствии с политикой. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz | Текущая частота, на которой работает процессор. |
cpuInfo[].logicalCpus[].idleDuration | Время простоя с момента последней загрузки. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
cpuInfo[].logicalCpus[].cStates[] | C-состояния указывают состояние энергопотребления ЦП. Для получения дополнительной информации обратитесь к документации, опубликованной производителем процессора. |
cpuInfo[].logicalCpus[].cStates[].displayName | Название штата. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration | Время нахождения в состоянии с момента последней перезагрузки. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
deviceFiles[] | Список файлов устройства для загрузки (только чтение) |
deviceFiles[].name | Имя файла |
deviceFiles[].type | Тип файла |
deviceFiles[].downloadUrl | URL-адрес загрузки файла |
deviceFiles[].createTime | Дата и время создания файла |
systemRamFreeReports[] | Отчеты об объемах доступной оперативной памяти (только чтение) |
systemRamFreeReports[].reportTime | Дата и время получения отчета. |
systemRamFreeReports[].systemRamFreeInfo[] | |
lastKnownNetwork[] | Содержит последнюю известную сеть (только чтение) |
lastKnownNetwork[].ipAddress | IP-адрес. |
lastKnownNetwork[].wanIpAddress | IP-адрес WAN. |
autoUpdateExpiration | (Только для чтения) Временная метка, после которой устройство перестанет получать обновления или поддержку Chrome. Вместо этого используйте «autoUpdateThrough». |
ethernetMacAddress0 | (Только для чтения) MAC-адрес, используемый внутренним портом Ethernet Chromebook и встроенным сетевым интерфейсом (Ethernet). Формат — двенадцать (12) шестнадцатеричных цифр без разделителя (заглавные буквы). Это актуально только для некоторых устройств. |
dockMacAddress | (Только для чтения) Встроенный MAC-адрес док-станции, к которой подключено устройство. Заводские настройки: адрес управления доступом к среде передачи данных (MAC-адрес), назначенный для использования док-станцией. Он зарезервирован специально для политики прохождения MAC-адресов устройств. Формат — двенадцать (12) шестнадцатеричных цифр без разделителя (прописные буквы). Это актуально только для некоторых устройств. |
manufactureDate | (Только для чтения) Дата изготовления устройства в формате гггг-мм-дд. |
orgUnitPath | Полный родительский путь с названием организационного подразделения, связанного с устройством. Имена путей нечувствительны к регистру. Если родительская организационная единица является организацией верхнего уровня, она обозначается косой чертой |
tpmVersionInfo | Доверенный платформенный модуль (TPM) (только чтение) |
tpmVersionInfo.family | Семья ТПМ. Мы используем кодировку стиля TPM 2.0, например: |
tpmVersionInfo.specLevel | Уровень спецификации TPM. См. спецификацию библиотеки для TPM 2.0 и основную спецификацию для TPM 1.2. |
tpmVersionInfo.manufacturer | Код производителя TPM. |
tpmVersionInfo.tpmModel | Номер модели TPM. |
tpmVersionInfo.firmwareVersion | Версия прошивки TPM. |
tpmVersionInfo.vendorSpecific | Информация, специфичная для поставщика, такая как идентификатор поставщика. |
screenshotFiles[] | Список файлов скриншотов для загрузки. Тип всегда «SCREENSHOT_FILE». (Только чтение) |
screenshotFiles[].name | Имя файла |
screenshotFiles[].type | Тип файла |
screenshotFiles[].downloadUrl | URL-адрес загрузки файла |
screenshotFiles[].createTime | Дата и время создания файла |
orgUnitId | Уникальный идентификатор организационного подразделения. orgUnitPath — это удобочитаемая версия orgUnitId. Хотя orgUnitPath можно изменить путем переименования организационного подразделения в пути, orgUnitId нельзя изменить ни для одного организационного подразделения. Это свойство можно обновить с помощью API. Дополнительную информацию о том, как создать организационную структуру для вашего устройства, см. в справочном центре администрирования . |
osUpdateStatus | Статус обновлений ОС для устройства. |
firstEnrollmentTime | Дата и время первой регистрации устройства. |
lastDeprovisionTimestamp | (Только для чтения) Дата и время последнего отключения устройства. |
deprovisionReason | (Только чтение) Причина деинициализации. |
deviceLicenseType | Только вывод. Тип лицензии на устройство. |
backlightInfo[] | Только вывод. Содержит информацию о подсветке устройства. |
autoUpdateThrough | Только вывод. Временная метка, после которой устройство перестанет получать обновления или поддержку Chrome. |
extendedSupportEligible | Только вывод. Требуется ли для устройства согласие на расширенную поддержку. |
extendedSupportStart | Только вывод. Дата устройства, когда начинается политика расширенной поддержки автоматических обновлений. |
extendedSupportEnabled | Только вывод. Включена ли на устройстве политика расширенной поддержки. |
fanInfo[] | Только вывод. Информация о вентиляторе устройства. |
chromeOsType | Только вывод. Тип Chrome OS устройства. |
diskSpaceUsage | Только вывод. Сколько дискового пространства доступно и используется устройством. |
Осупдатестатус
Содержит информацию о текущем состоянии обновления ОС.
JSON-представление |
---|
{
"state": enum ( |
Поля | |
---|---|
state | Состояние обновления ОС. |
targetOsVersion | Новая версия образа ОС загружается и применяется. Он устанавливается только в том случае, если статус обновления — UPDATE_STATUS_DOWNLOAD_IN_PROGRESS или UPDATE_STATUS_NEED_REBOOT. Обратите внимание, что это может быть фиктивное значение «0.0.0.0» для UPDATE_STATUS_NEED_REBOOT в некоторых крайних случаях, например, механизм обновления перезапускается без перезагрузки. |
targetKioskAppVersion | Новая необходимая версия платформы из ожидаемого обновленного киоск-приложения. |
updateTime | Дата и время последнего успешного обновления ОС. |
updateCheckTime | Дата и время последней проверки обновлений. |
rebootTime | Дата и время последней перезагрузки. |
Обновлениестате
Состояние обновления ОС.
Перечисления | |
---|---|
UPDATE_STATE_UNSPECIFIED | Состояние обновления не указано. |
UPDATE_STATE_NOT_STARTED | Ожидается обновление, но оно не запущено. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS | Ожидаемое обновление загружается. |
UPDATE_STATE_NEED_REBOOT | Устройство готово к установке обновления, но должно перезагрузиться. |
Причина деинициализации
Причина деинициализации устройства ChromeOS.
Перечисления | |
---|---|
DEPROVISION_REASON_UNSPECIFIED | Причина отключения неизвестна. |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT | Замена той же модели. У вас есть разрешение на возврат материалов (RMA) или вы заменяете неисправное устройство по гарантии на устройство той же модели. |
DEPROVISION_REASON_UPGRADE | Устройство было модернизировано. |
DEPROVISION_REASON_DOMAIN_MOVE | Домен устройства был изменен. |
DEPROVISION_REASON_SERVICE_EXPIRATION | Срок действия услуги для устройства истек. |
DEPROVISION_REASON_OTHER | Устройство было деинициализировано по устаревшей причине, которая больше не поддерживается. |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT | Замена другой модели. Вы заменяете это устройство на обновленную или более новую модель устройства. |
DEPROVISION_REASON_RETIRING_DEVICE | Уход из флота. Вы передаете в дар, выбрасываете или иным образом выводите устройство из использования. |
DEPROVISION_REASON_UPGRADE_TRANSFER | Перенос обновления ChromeOS Flex. Это устройство ChromeOS Flex, которое вы заменяете на Chromebook в течение года. |
DEPROVISION_REASON_NOT_REQUIRED | Причина не требовалась. Например, лицензии были возвращены в пул лицензий клиента. |
DEPROVISION_REASON_REPAIR_CENTER | Устройство было деинициализировано Сервисным центром ремонта. Может быть установлен только сервисным центром ремонта во время RMA. |
Тип лицензии устройства
Тип лицензии этого устройства.
Перечисления | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED | Тип лицензии неизвестен. |
ENTERPRISE | Устройство поставляется с бессрочным обновлением Chrome Enterprise. |
ENTERPRISE_UPGRADE | Для устройства предоставляется ежегодное автономное обновление Chrome Enterprise. |
EDUCATION_UPGRADE | Устройство имеет бессрочную автономную версию Chrome Education Upgrade. |
EDUCATION | В комплект поставки устройства входит бессрочное обновление Chrome Education. |
KIOSK_UPGRADE | Устройство имеет ежегодное обновление киоска. |
Информация о подсветке
Информация о подсветке устройства.
JSON-представление |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
Поля | |
---|---|
path | Только вывод. Путь к этой подсветке в системе. Полезно, если вызывающему абоненту необходимо сопоставить другую информацию. |
maxBrightness | Только вывод. Максимальная яркость подсветки. |
brightness | Только вывод. Текущая яркость подсветки, от 0 до maxBrightness. |
ФанИнфо
Информация о вентиляторе устройства.
JSON-представление |
---|
{ "speedRpm": integer } |
Поля | |
---|---|
speedRpm | Только вывод. Скорость вентилятора в об/мин. |
ChromeOsType
Тип Chrome OS устройства.
Перечисления | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED | Тип ОС Chrome не указан. |
CHROME_OS_FLEX | Тип ОС Chrome: Chrome OS Flex. |
CHROME_OS | ОС Chrome Введите ОС Chrome. |
Использование байтов
Представляет емкость данных с некоторым объемом текущего использования в байтах.
JSON-представление |
---|
{ "capacityBytes": string, "usedBytes": string } |
Поля | |
---|---|
capacityBytes | Только вывод. Общее значение емкости в байтах. |
usedBytes | Только вывод. Текущее значение использования в байтах. |
Методы | |
---|---|
(deprecated) | Вместо этого используйте BatchChangeChromeOsDeviceStatus . |
| Получает свойства устройства Chrome OS. |
| Получает постраничный список устройств Chrome OS в учетной записи. |
| Перемещает или добавляет несколько устройств Chrome OS в организационное подразделение. |
| Обновляет обновляемые свойства устройства, такие как annotatedUser , annotatedLocation , notes , orgUnitPath или annotatedAssetId . |
| Обновляет обновляемые свойства устройства, такие как annotatedUser , annotatedLocation , notes , orgUnitPath или annotatedAssetId . |