Recurso: ChromeOsDevice
Los dispositivos Google Chrome ejecutan ChromeOS. Para obtener más información sobre las 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 |
Es el ID único del dispositivo Chrome. |
serialNumber |
Es 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 |
Es el estado del dispositivo. Los valores aceptables son:
|
lastSync |
Fecha y hora en que se sincronizó el dispositivo por última vez con la configuración de la política en la Consola del administrador. El valor está en formato de fecha y hora ISO 8601. La hora es la fecha completa más horas, minutos y segundos en el formato |
supportEndDate |
Es la fecha final en la que se admitirá el dispositivo. Esto solo se aplica a los dispositivos comprados directamente en Google. El valor está en formato de fecha y hora ISO 8601. La hora es la fecha completa más horas, minutos y segundos en el formato |
annotatedUser |
Es el usuario del dispositivo, según lo indica el administrador. La longitud máxima es de 100 caracteres. Se permiten valores vacíos. |
annotatedLocation |
Dirección o ubicación del dispositivo, según lo indica 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 |
Es la información del modelo del dispositivo. Si el dispositivo no tiene esta información, la propiedad no se incluye en la respuesta. |
meid |
El identificador de equipo móvil (MEID) o la identidad internacional de equipo móvil (IMEI) de la tarjeta móvil 3G en un dispositivo móvil Por lo general, se usa un MEID o IMEI cuando se agrega un dispositivo a un plan de servicio pospago de un operador inalámbrico. Si el dispositivo no tiene esta información, la propiedad no se incluye en la respuesta. Para obtener más información sobre cómo exportar una lista de MEID/IMEI, consulta la Guía para desarrolladores. |
orderNumber |
Es el número de pedido del dispositivo. Solo los dispositivos que se compran directamente en Google tienen un número de pedido. |
willAutoRenew |
Determina si el dispositivo renovará automáticamente su asistencia después de la fecha de finalización de la asistencia. Esta propiedad es de solo lectura. |
osVersion |
Es la versión del sistema operativo del dispositivo Chrome. |
platformVersion |
Es la versión de la plataforma del dispositivo Chrome. |
firmwareVersion |
Es la versión de firmware del dispositivo Chrome. |
macAddress |
Es 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 |
Fecha y hora en que se inscribió el dispositivo por última vez El valor está en formato de fecha y hora ISO 8601. La hora es la fecha completa más horas, minutos y segundos en el formato |
kind |
Es el tipo de recurso. Para el recurso Chromeosdevices, el valor es |
recentUsers[] |
Es una lista de los usuarios recientes del dispositivo, en orden descendente, según la 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 períodos activos (solo lectura). |
activeTimeRanges[].activeTime |
Es la 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 recurso que indica un administrador o que se especifica durante la inscripción. |
etag |
ETag del recurso. |
diskVolumeReports[] |
Informes sobre el espacio en disco y otra información sobre los volúmenes conectados o activados. |
diskVolumeReports[].volumeInfo[] |
Volúmenes de disco |
diskVolumeReports[].volumeInfo[].volumeId |
ID del volumen |
diskVolumeReports[].volumeInfo[].storageTotal |
Espacio total del disco [en bytes] |
diskVolumeReports[].volumeInfo[].storageFree |
Espacio disponible en el disco [en bytes] |
systemRamTotal |
RAM total 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[] |
Es una lista de muestras de temperatura de la CPU. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Temperatura en grados Celsius |
cpuStatusReports[].cpuTemperatureInfo[].label |
Etiqueta de CPU |
cpuInfo[] |
Es información sobre las especificaciones de la CPU del dispositivo. |
cpuInfo[].model |
Es el nombre del modelo de la CPU. |
cpuInfo[].architecture |
Es la arquitectura de la CPU. |
cpuInfo[].maxClockSpeedKhz |
Velocidad máxima de reloj de la CPU en kHz |
cpuInfo[].logicalCpus[] |
Información sobre las CPUs lógicas |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Frecuencia máxima a la que se permite que se ejecute la CPU, según la política. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Frecuencia actual a 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 |
Nombre del estado. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Tiempo que se pasó en el estado desde el último reinicio. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
deviceFiles[] |
Es una 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 cantidades 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 |
Es la dirección IP de WAN. |
autoUpdateExpiration |
(Solo lectura) Es la marca de tiempo posterior a la cual el dispositivo dejará de recibir actualizaciones o asistencia de Chrome. En su lugar, usa "autoUpdateThrough". |
ethernetMacAddress0 |
(Solo lectura) Dirección MAC que usa el puerto Ethernet interno de la Chromebook y la interfaz de red (Ethernet) integrada. El formato es de doce (12) dígitos hexadecimales sin ningún delimitador (letras en mayúscula). Esto solo es relevante para algunos dispositivos. |
dockMacAddress |
(Solo lectura) Dirección MAC integrada de la estación de conexión a la que se conectó el dispositivo. La fábrica establece la dirección de control de acceso a medios (dirección MAC) asignada para el uso de un conector. Se reserva específicamente para la política de dispositivos de transferencia de MAC. El formato es de doce (12) dígitos hexadecimales sin ningún delimitador (letras en mayúscula). Esto solo es relevante para algunos dispositivos. |
manufactureDate |
(Solo lectura) Fecha de fabricación del dispositivo en formato aaaa-mm-dd. |
orgUnitPath |
Es la ruta de acceso principal completa con el nombre de la unidad organizativa asociada al dispositivo. Los nombres de ruta no distinguen mayúsculas de minúsculas. Si la unidad organizativa principal 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 |
Familia de TPM. Usamos la codificación de estilo TPM 2.0, p.ej.: |
tpmVersionInfo.specLevel |
Es el 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 |
Es el código del fabricante del TPM. |
tpmVersionInfo.tpmModel |
Número de modelo del TPM. |
tpmVersionInfo.firmwareVersion |
Versión de firmware del TPM. |
tpmVersionInfo.vendorSpecific |
Información específica del proveedor, como el ID del proveedor |
screenshotFiles[] |
Es una lista de archivos de capturas 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 de orgUnitId. Si bien orgUnitPath puede cambiar si se cambia el nombre de una unidad organizativa dentro de la ruta de acceso, 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 para administradores. |
osUpdateStatus |
Es 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 de la última cancelación del aprovisionamiento del dispositivo. |
deprovisionReason |
(Solo lectura) Es el motivo de la cancelación del aprovisionamiento. |
deviceLicenseType |
Solo salida. Es el tipo de licencia del dispositivo. |
backlightInfo[] |
Solo salida. Contiene información sobre la luz de fondo del dispositivo. |
autoUpdateThrough |
Solo salida. Es la marca de tiempo posterior a la cual el dispositivo dejará de recibir actualizaciones o asistencia de Chrome. |
extendedSupportEligible |
Solo salida. Indica si el dispositivo requiere la aceptación de la compatibilidad extendida. |
extendedSupportStart |
Solo salida. Fecha del dispositivo en la que comienza la política de asistencia extendida para las actualizaciones automáticas. |
extendedSupportEnabled |
Solo salida. Indica si la política de asistencia extendida está habilitada en el dispositivo. |
fanInfo[] |
Solo salida. Es la información del ventilador del dispositivo. |
chromeOsType |
Solo salida. Tipo de ChromeOS del dispositivo. |
diskSpaceUsage |
Solo salida. Cantidad de espacio en el disco disponible y en uso del dispositivo. |
osVersionCompliance |
Solo salida. Es el estado de cumplimiento de la política del dispositivo de la versión del SO. |
OsUpdateStatus
Contiene información sobre el estado actual de la actualización del SO.
Representación JSON |
---|
{
"state": enum ( |
Campos | |
---|---|
state |
Es el estado de actualización de una actualización del SO. |
targetOsVersion |
Se está descargando y aplicando una nueva versión de la plataforma de la imagen del SO. 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 "0.0.0.0" ficticio para UPDATE_STATUS_NEED_REBOOT en algunos casos extremos, p.ej., se reinicia el motor de actualización sin reiniciar el dispositivo. |
targetKioskAppVersion |
Es la nueva versión de la plataforma requerida de la app para kioscos actualizada pendiente. |
updateTime |
Fecha y hora de la última actualización correcta del SO. |
updateCheckTime |
Fecha y hora de la última verificación de actualización. |
rebootTime |
Fecha y hora del último reinicio. |
UpdateState
Es el estado de actualización de una actualización del SO.
Enumeraciones | |
---|---|
UPDATE_STATE_UNSPECIFIED |
El estado de actualización no está especificado. |
UPDATE_STATE_NOT_STARTED |
Hay una actualización pendiente, pero no se inició. |
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
Es el motivo por el que se desaprovisionó un dispositivo ChromeOS.
Enumeraciones | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
Se desconoce el motivo de la cancelación del aprovisionamiento. |
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 |
El servicio venció para el dispositivo. |
DEPROVISION_REASON_OTHER |
El dispositivo se desaprovisionó por un motivo heredado que ya no se admite. |
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 |
Se retirará 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 grupo de licencias del cliente. |
DEPROVISION_REASON_REPAIR_CENTER |
El Centro de reparación desaprovisionó el dispositivo. Solo el centro de reparación puede establecerlo durante la devolución de mercancía. |
DeviceLicenseType
Es el tipo de licencia de este dispositivo.
Enumeraciones | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
Se desconoce el tipo de licencia. |
ENTERPRISE |
El dispositivo incluye una actualización perpetua de Chrome Enterprise. |
ENTERPRISE_UPGRADE |
El dispositivo tiene una actualización de Chrome Enterprise independiente anual. |
EDUCATION_UPGRADE |
El dispositivo tiene una actualización de Chrome Education independiente y perpetua. |
EDUCATION |
El dispositivo incluye una actualización perpetua de Chrome Education. |
KIOSK_UPGRADE |
El dispositivo tiene una actualización anual de Kiosk. |
ENTERPRISE_UPGRADE_PERPETUAL |
Indica que el dispositivo está usando una actualización de Chrome Enterprise perpetua independiente, es decir, una licencia de Chrome Enterprise. |
ENTERPRISE_UPGRADE_FIXED_TERM |
Indica que el dispositivo está consumiendo una actualización de Chrome Enterprise independiente y de plazo fijo, es decir, una licencia de Chrome Enterprise. |
EDUCATION_UPGRADE_PERPETUAL |
Indica que el dispositivo está consumiendo una actualización de Chrome Education independiente y perpetua(también conocida como licencia perpetua de Chrome EDU). |
EDUCATION_UPGRADE_FIXED_TERM |
Indica que el dispositivo está consumiendo una actualización de Chrome Education independiente y de plazo fijo(también conocida como licencia de plazo fijo de Chrome EDU). |
BacklightInfo
Es información sobre la luz de fondo del dispositivo.
Representación JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
Campos | |
---|---|
path |
Solo salida. Es la ruta de acceso a esta luz de fondo en el sistema. Es útil si el llamador necesita correlacionar con otra información. |
maxBrightness |
Solo salida. Es el brillo máximo de la retroiluminación. |
brightness |
Solo salida. Es el brillo actual de la retroiluminación, entre 0 y maxBrightness. |
FanInfo
Es información sobre el ventilador del dispositivo.
Representación JSON |
---|
{ "speedRpm": integer } |
Campos | |
---|---|
speedRpm |
Solo salida. Velocidad del ventilador en RPM. |
ChromeOsType
Tipo de ChromeOS del dispositivo.
Enumeraciones | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
No se especificó el tipo de ChromeOS. |
CHROME_OS_FLEX |
Tipo de ChromeOS: ChromeOS Flex. |
CHROME_OS |
Escribe ChromeOS. |
ByteUsage
Representa una capacidad de datos con una cierta cantidad de uso actual en bytes.
Representación JSON |
---|
{ "capacityBytes": string, "usedBytes": string } |
Campos | |
---|---|
capacityBytes |
Solo salida. Es el valor de capacidad total, en bytes. |
usedBytes |
Solo salida. Es el valor de uso actual, en bytes. |
Cumplimiento
Es el estado de cumplimiento de la política del dispositivo de la versión del SO.
Enumeraciones | |
---|---|
COMPLIANCE_UNSPECIFIED |
No se especificó el estado de cumplimiento. |
COMPLIANT |
El estado de cumplimiento es conforme. |
PENDING |
El estado de cumplimiento está pendiente. |
NOT_COMPLIANT |
El estado de cumplimiento no es conforme. |
Métodos |
|
---|---|
(deprecated) |
En su lugar, usa BatchChangeChromeOsDeviceStatus. |
|
Recupera las propiedades de un dispositivo ChromeOS. |
|
Recupera una lista paginada de dispositivos Chrome OS dentro de una cuenta. |
|
Mueve o inserta varios dispositivos ChromeOS en una unidad organizativa. |
|
Actualiza las propiedades actualizables de un dispositivo, como annotatedUser , annotatedLocation , notes , orgUnitPath o annotatedAssetId . |
|
Actualiza las propiedades actualizables de un dispositivo, como annotatedUser , annotatedLocation , notes , orgUnitPath o annotatedAssetId . |