Recurso: ChromeOsDevice
Los dispositivos Google Chrome se ejecutan en el Sistema operativo Chrome. Para obtener más información sobre tareas comunes de la API, consulta la Guía para desarrolladores.
Representación 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 ( |
Campos | |
---|---|
deviceId |
El ID único del dispositivo Chrome. |
serialNumber |
El número de serie del dispositivo Chrome que se ingresó cuando se habilitó el dispositivo. Este valor es el mismo que el Número de serie de la Consola del administrador en la pestaña Dispositivos ChromeOS. |
status |
Estado del dispositivo. Los valores aceptables son:
|
lastSync |
La fecha y hora en que el dispositivo se sincronizó por última vez con la configuración de la política en la Consola del administrador. El valor está en el formato de fecha y hora ISO 8601. La hora es la fecha completa más horas, minutos y segundos en el formulario |
supportEndDate |
La fecha final en la que se admitirá el dispositivo. Esto se aplica solo a los dispositivos comprados directamente en Google. El valor está en el formato de fecha y hora ISO 8601. La hora es la fecha completa más horas, minutos y segundos en el formulario |
annotatedUser |
El usuario del dispositivo indicado por el administrador. La longitud máxima es de 100 caracteres. Se permiten valores vacíos. |
annotatedLocation |
Es la dirección o ubicación del dispositivo que indique el administrador. La longitud máxima es de |
notes |
Notas sobre este dispositivo agregadas por el administrador. Esta propiedad se puede buscar con el parámetro |
model |
La información del modelo del dispositivo. Si el dispositivo no tiene esta información, esta propiedad no se incluye en la respuesta. |
meid |
Es el identificador de equipo móvil (MEID) o la identidad internacional de equipo móvil (IMEI) correspondiente a la tarjeta móvil 3G de un dispositivo móvil. Por lo general, se usa un MEID/IMEI cuando se agrega un dispositivo al plan de servicios pospago de un proveedor de servicios inalámbricos. Si el dispositivo no tiene esta información, esta propiedad no se incluye en la respuesta. Si quieres obtener más información para exportar una lista de MEID/IMEI, consulta la Guía para desarrolladores. |
orderNumber |
Número de pedido del dispositivo Solo los dispositivos que se compraron directamente a Google tienen un número de pedido. |
willAutoRenew |
Determina si el dispositivo renovará automáticamente la compatibilidad después de la fecha de finalización de la compatibilidad. Esta es una propiedad de solo lectura. |
osVersion |
La versión del sistema operativo del dispositivo Chrome. |
platformVersion |
La versión de la plataforma del dispositivo Chrome. |
firmwareVersion |
La versión de firmware del dispositivo Chrome. |
macAddress |
La dirección MAC inalámbrica del dispositivo. Si el dispositivo no tiene esta información, no se incluye en la respuesta. |
bootMode |
Es el modo de inicio del dispositivo. Los siguientes son los valores posibles:
|
lastEnrollmentTime |
La fecha y hora en que se inscribió el dispositivo por última vez. El valor está en el formato de fecha y hora ISO 8601. La hora es la fecha completa más horas, minutos y segundos en el formulario |
kind |
Es el tipo de recurso. Para el recurso Chromeosdevices, el valor es |
recentUsers[] |
Una lista de los usuarios recientes del dispositivo, en orden descendente, por hora del último acceso. |
recentUsers[].type |
Es el tipo de usuario. Los valores aceptables son:
|
recentUsers[].email |
La dirección de correo electrónico del usuario. Solo está presente si el tipo de usuario es |
activeTimeRanges[] |
Es una lista de los intervalos de tiempo activos (solo lectura). |
activeTimeRanges[].activeTime |
Duración del uso en milisegundos. |
activeTimeRanges[].date |
Fecha de uso. |
ethernetMacAddress |
Es la dirección MAC del dispositivo en la interfaz de red Ethernet. |
annotatedAssetId |
Es el identificador de recursos que indica un administrador o que se especifica durante la inscripción. |
etag |
ETag del recurso. |
diskVolumeReports[] |
Informes de espacio en el disco y otra información sobre volúmenes activados o conectados |
diskVolumeReports[].volumeInfo[] |
Volúmenes de disco |
diskVolumeReports[].volumeInfo[].volumeId |
ID del volumen |
diskVolumeReports[].volumeInfo[].storageTotal |
Espacio total en el disco [en bytes] |
diskVolumeReports[].volumeInfo[].storageFree |
Espacio libre en el disco [en bytes] |
systemRamTotal |
Total de RAM del dispositivo en bytes |
cpuStatusReports[] |
Informes de uso y temperatura de la CPU (solo lectura) |
cpuStatusReports[].reportTime |
Fecha y hora en que se recibió el informe. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Una lista de muestras de la temperatura de la CPU. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Temperatura en grados Celsius |
cpuStatusReports[].cpuTemperatureInfo[].label |
Etiqueta de la CPU |
cpuInfo[] |
Información sobre las especificaciones de CPU del dispositivo. |
cpuInfo[].model |
El nombre del modelo de CPU. |
cpuInfo[].architecture |
Arquitectura de la CPU |
cpuInfo[].maxClockSpeedKhz |
La velocidad de reloj máxima de la CPU en kHz. |
cpuInfo[].logicalCpus[] |
Información para las CPU lógicas |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Frecuencia máxima que puede ejecutarse la CPU, por política. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Frecuencia actual con la que se ejecuta la CPU. |
cpuInfo[].logicalCpus[].idleDuration |
Tiempo de inactividad desde el último inicio. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
cpuInfo[].logicalCpus[].cStates[] |
Los estados C indican el estado de consumo de energía de la CPU. Para obtener más información, consulta la documentación publicada por el fabricante de la CPU. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Es el nombre del estado. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Tiempo en el estado desde el último reinicio. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
deviceFiles[] |
Lista de archivos del dispositivo para descargar (solo lectura) |
deviceFiles[].name |
Nombre del archivo |
deviceFiles[].type |
File type |
deviceFiles[].downloadUrl |
URL de descarga del archivo |
deviceFiles[].createTime |
Fecha y hora en que se creó el archivo |
systemRamFreeReports[] |
Informes de la cantidad de memoria RAM disponible (solo lectura). |
systemRamFreeReports[].reportTime |
Fecha y hora en que se recibió el informe. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
Contiene la última red conocida (solo lectura) |
lastKnownNetwork[].ipAddress |
Es la dirección IP. |
lastKnownNetwork[].wanIpAddress |
La dirección IP de la WAN. |
autoUpdateExpiration |
(Solo lectura) La marca de tiempo después de la cual el dispositivo dejará de recibir actualizaciones o asistencia de Chrome. Usa "autoUpdatethrough" en su lugar. |
ethernetMacAddress0 |
(Solo lectura) Dirección MAC que utiliza el puerto Ethernet interno de la Chromebook y para la interfaz de red integrada (Ethernet). El formato tiene doce (12) dígitos hexadecimales sin delimitador (letras mayúsculas). Esto solo es relevante para algunos dispositivos. |
dockMacAddress |
(Solo lectura) Dirección MAC integrada para la estación de conexión a la que se conectó el dispositivo. La configuración de fábrica establece la dirección de control de acceso a medios (dirección MAC) asignada para que la use un conector. Está reservada específicamente para la política de dispositivo de transferencia de MAC. El formato tiene doce (12) dígitos hexadecimales sin delimitador (letras mayúsculas). Esto solo es relevante para algunos dispositivos. |
manufactureDate |
(Solo lectura) Es la fecha en que se fabricó el dispositivo en formato aaaa-mm-dd. |
orgUnitPath |
Es la ruta de acceso superior completa con el nombre de la unidad organizativa asociada al dispositivo. Los nombres de las rutas de acceso no distinguen mayúsculas de minúsculas. Si la unidad organizativa superior es la organización de nivel superior, se representa con una barra diagonal |
tpmVersionInfo |
Módulo de plataforma de confianza (TPM) (solo lectura) |
tpmVersionInfo.family |
TPM. Usamos la codificación de estilo TPM 2.0, por ejemplo: |
tpmVersionInfo.specLevel |
Nivel de especificación del TPM. Consulta la especificación de la biblioteca para TPM 2.0 y la especificación principal para TPM 1.2. |
tpmVersionInfo.manufacturer |
Código del fabricante del TPM. |
tpmVersionInfo.tpmModel |
Número de modelo del TPM. |
tpmVersionInfo.firmwareVersion |
Versión de firmware TPM. |
tpmVersionInfo.vendorSpecific |
Información específica del proveedor, como el ID del proveedor |
screenshotFiles[] |
Una lista de archivos de captura de pantalla para descargar. El tipo siempre es "SCREENSHOT_FILE". (solo lectura) |
screenshotFiles[].name |
Nombre del archivo |
screenshotFiles[].type |
File type |
screenshotFiles[].downloadUrl |
URL de descarga del archivo |
screenshotFiles[].createTime |
Fecha y hora en que se creó el archivo |
orgUnitId |
Es el ID único de la unidad organizativa. orgUnitPath es la versión legible por humanos de orgUnitId. Si bien orgUnitPath puede cambiar cuando se le cambia el nombre a una unidad organizativa dentro de la ruta, orgUnitId no se puede cambiar para una unidad organizativa. Esta propiedad se puede actualizar con la API. Para obtener más información sobre cómo crear una estructura organizativa para tu dispositivo, consulta el Centro de ayuda de administración. |
osUpdateStatus |
El estado de las actualizaciones del SO del dispositivo. |
firstEnrollmentTime |
Fecha y hora de la primera vez que se inscribió el dispositivo. |
lastDeprovisionTimestamp |
(Solo lectura) Fecha y hora del último desaprovisionamiento del dispositivo. |
deprovisionReason |
(Solo lectura) Motivo de desaprovisionamiento. |
deviceLicenseType |
Solo salida. Tipo de licencia del dispositivo. |
backlightInfo[] |
Solo salida. Contiene información de retroiluminación del dispositivo. |
autoUpdateThrough |
Solo salida. La marca de tiempo después de la cual el dispositivo dejará de recibir actualizaciones o asistencia de Chrome. |
extendedSupportEligible |
Solo salida. Indica si el dispositivo requiere la habilitación de la asistencia extendida o no. |
extendedSupportStart |
Solo salida. Es la fecha del dispositivo en la que comienza la política de compatibilidad extendida para actualizaciones automáticas. |
extendedSupportEnabled |
Solo salida. Si la política de asistencia extendida está habilitada en el dispositivo |
fanInfo[] |
Solo salida. Información del ventilador del dispositivo. |
chromeOsType |
Solo salida. Es el tipo de ChromeOS del dispositivo. |
OsUpdateStatus
Contiene información sobre el estado actual de la actualización del SO.
Representación JSON |
---|
{
"state": enum ( |
Campos | |
---|---|
state |
El estado de actualización de una actualización del SO. |
targetOsVersion |
Nueva versión de plataforma de la imagen de SO que se descarga y se aplica. Solo se establece cuando el estado de actualización es UPDATE_STATUS_DOWNLOAD_IN_PROGRESS o UPDATE_STATUS_NEED_REBOOT. Ten en cuenta que podría ser un valor ficticio “0.0.0.0” para UPDATE_STATUS_NEED_REBOOT en algunos casos extremos, p.ej., el motor de actualización se reinicia sin reiniciarlo. |
targetKioskAppVersion |
Nueva versión obligatoria de la plataforma de la aplicación de kiosco actualizada pendiente. |
updateTime |
Fecha y hora de la última actualización exitosa del SO. |
updateCheckTime |
Fecha y hora de la última búsqueda de actualizaciones. |
rebootTime |
Fecha y hora del último reinicio. |
UpdateState
El estado de actualización de una actualización del SO.
Enumeraciones | |
---|---|
UPDATE_STATE_UNSPECIFIED |
El estado de la actualización no está especificado. |
UPDATE_STATE_NOT_STARTED |
Hay una actualización pendiente, pero no comenzó. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
Se está descargando la actualización pendiente. |
UPDATE_STATE_NEED_REBOOT |
El dispositivo está listo para instalar la actualización, pero debe reiniciarse. |
DeprovisionReason
El motivo por el que se desaprovisionó un dispositivo ChromeOS.
Enumeraciones | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
Se desconoce el motivo del desaprovisionamiento. |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
Reemplazo por el mismo modelo. Tienes autorización de devolución de materiales (RMA) o reemplazarás un dispositivo que funciona mal bajo garantía por el mismo modelo de dispositivo. |
DEPROVISION_REASON_UPGRADE |
Se actualizó el dispositivo. |
DEPROVISION_REASON_DOMAIN_MOVE |
Se cambió el dominio del dispositivo. |
DEPROVISION_REASON_SERVICE_EXPIRATION |
Venció el servicio para el dispositivo. |
DEPROVISION_REASON_OTHER |
El dispositivo se desaprovisionó por un motivo heredado que ya no es compatible. |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
Reemplazo por otro modelo. Reemplazarás este dispositivo por un modelo de dispositivo actualizado o más reciente. |
DEPROVISION_REASON_RETIRING_DEVICE |
Retiro de la flota. Donarás, descartarás o darás de baja el dispositivo. |
DEPROVISION_REASON_UPGRADE_TRANSFER |
Transferencia de actualización de ChromeOS Flex. Este es un dispositivo ChromeOS Flex que reemplazarás por una Chromebook dentro de un año. |
DEPROVISION_REASON_NOT_REQUIRED |
No se requería un motivo. Por ejemplo, las licencias se devolvieron al conjunto de licencias del cliente. |
DEPROVISION_REASON_REPAIR_CENTER |
El Centro de servicio de reparación desaprovisionó el dispositivo. Solo lo puede establecer el centro de reparación durante la ADP. |
DeviceLicenseType
El tipo de licencia de este dispositivo.
Enumeraciones | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
El tipo de licencia es desconocido. |
ENTERPRISE |
El dispositivo incluye una actualización perpetua de Chrome Enterprise. |
ENTERPRISE_UPGRADE |
El dispositivo cuenta con una actualización independiente de Chrome Enterprise anual. |
EDUCATION_UPGRADE |
El dispositivo tendrá una actualización perpetua independiente de Chrome Education. |
EDUCATION |
El dispositivo incluye una actualización perpetua de Chrome Education. |
KIOSK_UPGRADE |
El dispositivo tiene una actualización de kiosco anual. |
BacklightInfo
Información sobre la retroiluminación del dispositivo.
Representación JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
Campos | |
---|---|
path |
Solo salida. Es la ruta a esta retroiluminación en el sistema. Es útil si el emisor necesita relacionarse con otra información. |
maxBrightness |
Solo salida. Brillo máximo para la retroiluminación. |
brightness |
Solo salida. Brillo actual de la retroiluminación, entre 0 y maxBrightness |
FanInfo
Información sobre el ventilador del dispositivo.
Representación JSON |
---|
{ "speedRpm": integer } |
Campos | |
---|---|
speedRpm |
Solo salida. Velocidad del ventilador en RPM. |
ChromeOsType
Tipo de dispositivo con ChromeOS.
Enumeraciones | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
Tipo de ChromeOS sin especificar. |
CHROME_OS_FLEX |
Tipo de ChromeOS Flex de ChromeOS. |
CHROME_OS |
Tipo de ChromeOS. |
Métodos |
|
---|---|
(deprecated) |
En su lugar, usa BatchChangeChromeOsDeviceStatus. |
|
Recupera las propiedades de un dispositivo con Sistema operativo Chrome. |
|
Recupera una lista paginada de los dispositivos con Chrome OS de una cuenta. |
|
Mueve o inserta varios dispositivos ChromeOS en una unidad organizativa. |
|
Actualiza las propiedades que se pueden actualizar de un dispositivo, como annotatedUser , annotatedLocation , notes , orgUnitPath o annotatedAssetId . |
|
Actualiza las propiedades que se pueden actualizar de un dispositivo, como annotatedUser , annotatedLocation , notes , orgUnitPath o annotatedAssetId . |