Recurso: ChromeOsDevice
Los dispositivos Google Chrome funcionan con Chrome OS. Si deseas 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 |
El ID único del dispositivo Chrome. |
serialNumber |
Es el número de serie del dispositivo Chrome que se ingresó cuando se habilitó. 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 el dispositivo se sincronizó por última vez con la configuración de la política en la Consola del administrador. El valor debe tener el formato de fecha y hora ISO 8601. La hora es la fecha completa más las horas, los minutos y los segundos en el formato |
supportEndDate |
La fecha final en la que se admitirá el dispositivo. Esto se aplica solo a los dispositivos que se compraron directamente en Google. El valor debe tener el formato de fecha y hora ISO 8601. La hora es la fecha completa más las horas, los minutos y los segundos en el formato |
annotatedUser |
El usuario del dispositivo según lo que indicó 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 según lo 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 |
Es la información del modelo del dispositivo. Si el dispositivo no tiene esta información, no se incluirá esta propiedad en la respuesta. |
meid |
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 o 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, no se incluirá esta propiedad en la respuesta. Si quieres obtener más información para 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 compraron directamente a Google tienen un número de pedido. |
willAutoRenew |
Determina si el dispositivo renovará automáticamente su 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 incluirá 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 debe tener el formato de fecha y hora ISO 8601. La hora es la fecha completa más las horas, los minutos y los segundos en el formato |
kind |
Es el tipo de recurso. Para el recurso Chromeosdevices, el valor es |
recentUsers[] |
Una lista de usuarios recientes de dispositivos, 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[] |
Una lista de períodos de tiempo activos (solo lectura). |
activeTimeRanges[].activeTime |
Es la duración del uso, expresada en milisegundos. |
activeTimeRanges[].date |
Fecha de uso |
ethernetMacAddress |
La dirección MAC del dispositivo en la interfaz de red Ethernet. |
annotatedAssetId |
El identificador de recursos tal como lo indica un administrador o 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 de CPU y temperatura (solo lectura) |
cpuStatusReports[].reportTime |
Fecha y hora en que se recibió el informe. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Una lista de muestras de 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 la CPU del dispositivo. |
cpuInfo[].model |
El nombre del modelo de la CPU. |
cpuInfo[].architecture |
La arquitectura de la CPU |
cpuInfo[].maxClockSpeedKhz |
Es la velocidad máxima del reloj de la CPU en kHz. |
cpuInfo[].logicalCpus[] |
Información de las CPU lógicas |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Frecuencia máxima de ejecución de la CPU (según la 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 terminen 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 que publicó el fabricante de la CPU. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Es el nombre del estado. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Tiempo que se dedicó al estado desde el último reinicio. Una duración en segundos con hasta nueve dígitos decimales que terminen en " |
deviceFiles[] |
Una lista de los archivos del dispositivo para descargar (solo lectura) |
deviceFiles[].name |
Nombre del archivo |
deviceFiles[].type |
File type |
deviceFiles[].downloadUrl |
URL de descarga de archivos |
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 |
Indica la dirección IP. |
lastKnownNetwork[].wanIpAddress |
Es la dirección IP de WAN. |
autoUpdateExpiration |
(Solo lectura) La marca de tiempo después de la cual el dispositivo dejará de recibir actualizaciones o asistencia de Chrome. |
ethernetMacAddress0 |
La dirección MAC (solo lectura) que usa el puerto Ethernet interno de la Chromebook y la interfaz de la red integrada (Ethernet). El formato es de doce (12) dígitos hexadecimales sin ningún delimitador (letras mayúsculas). Esta opción 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. Establece de fábrica la dirección de control de acceso a medios (dirección MAC) asignada para que la use una estación de carga. Está reservada específicamente para la política de dispositivo de transferencia de MAC. El formato es de doce (12) dígitos hexadecimales sin ningún delimitador (letras mayúsculas). Esta opción solo es relevante para algunos dispositivos. |
manufactureDate |
(Solo lectura) Es la fecha en la 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 |
Familia TPM Usamos la codificación de estilo TPM 2.0, p.ej.: |
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 |
Es el código del fabricante del TPM. |
tpmVersionInfo.tpmModel |
Número de modelo del TPM. |
tpmVersionInfo.firmwareVersion |
Versión del firmware del TPM. |
tpmVersionInfo.vendorSpecific |
Información específica del proveedor, como su ID. |
screenshotFiles[] |
Una lista de los archivos de captura de pantalla que se descargarán. El tipo siempre es "SCREENSHOT_FILE". (solo lectura) |
screenshotFiles[].name |
Nombre del archivo |
screenshotFiles[].type |
File type |
screenshotFiles[].downloadUrl |
URL de descarga de archivos |
screenshotFiles[].createTime |
Fecha y hora en que se creó el archivo |
orgUnitId |
El ID único de la unidad organizativa. orgUnitPath es la versión legible de orgUnitId. Si bien orgUnitPath puede cambiar cuando se cambia el nombre de una unidad organizativa dentro de la ruta, orgUnitId no se puede cambiar para una unidad organizativa. Esta propiedad se puede actualizar con la API. Si quieres obtener más información para crear una estructura organizativa para el dispositivo, consulta el Centro de ayuda para administradores. |
osUpdateStatus |
Es el estado de las actualizaciones del SO del dispositivo. |
firstEnrollmentTime |
Indica la fecha y hora de la primera vez que se inscribió el dispositivo. |
lastDeprovisionTimestamp |
(Solo lectura) Fecha y hora del último desaprovisionamiento del dispositivo. |
deprovisionReason |
Motivo de desaprovisionamiento (solo lectura). |
deviceLicenseType |
Solo salida. Tipo de licencia del dispositivo. |
backlightInfo[] |
Solo salida. Contiene información de retroiluminación del dispositivo. |
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 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 la actualización es UPDATE_STATUS_download_IN_PROGRESS o UPDATE_STATUS_NEED_REBOOT. Ten en cuenta que, en algunos casos extremos, podría tratarse de un "0.0.0.0" ficticio, como cuando se reinicia el motor de actualizaciones sin reiniciarlo. |
targetKioskAppVersion |
Nueva versión obligatoria de la plataforma desde la aplicación de kiosco con actualización pendiente. |
updateTime |
Fecha y hora de la última actualización exitosa del SO. |
updateCheckTime |
Fecha y hora de la última verificación de actualizaciones. |
rebootTime |
Fecha y hora del último reinicio. |
UpdateState
Es el estado de una actualización del SO.
Enumeradores | |
---|---|
UPDATE_STATE_UNSPECIFIED |
El estado de la actualización no está especificado. |
UPDATE_STATE_NOT_STARTED |
Hay una actualización pendiente, pero aún 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 del desaprovisionamiento de un dispositivo ChromeOS.
Enumeradores | |
---|---|
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 del 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. El Centro de servicio de reparación solo puede configurarlo durante la ADP. |
DeviceLicenseType
Es el tipo de licencia de este dispositivo.
Enumeradores | |
---|---|
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 cuenta con una actualización independiente de Chrome Enterprise anual. |
EDUCATION_UPGRADE |
El dispositivo tiene una actualización independiente y perpetua de Chrome Education. |
EDUCATION |
El dispositivo incluye una actualización permanente 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. Ruta a esta retroiluminación en el sistema. Es útil si el llamador necesita correlacionarse 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 |
Métodos |
|
---|---|
(deprecated) |
En su lugar, usa BatchChangeChromeOsDeviceStatus. |
|
Recupera las propiedades de un dispositivo ChromeOS. |
|
Recupera una lista paginada de dispositivos ChromeOS 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 . |