REST Resource: chromeosdevices

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 (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType)
}
Campos
deviceId

string

El ID único del dispositivo Chrome.

serialNumber

string

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

string

Estado del dispositivo.

Los valores aceptables son:

  • ACTIVE: El dispositivo está inscrito en el dominio.
  • DELINQUENT: Venció la licencia anual del dominio, y el dispositivo ya no recibe políticas ni parámetros de configuración. Cuando se compra una nueva licencia, el dispositivo vuelve al estado ACTIVE.
  • PRE_PROVISIONED: El dispositivo se registró para la inscripción automática. Los dispositivos PRE_PROVISIONED se pueden borrar o mover a otra unidad organizativa. Una vez que se complete la inscripción, el dispositivo estará ACTIVE.
  • DEPROVISIONED: El dispositivo ya no es apto para inscribirlo en el dominio. Se canceló el pedido. La configuración del dispositivo se almacenó en la caché. Si se vuelve a activar el dispositivo, se aplicará la configuración más reciente del sistema a este dispositivo recién activado.
  • DISABLED: El administrador inhabilitó el dispositivo y no se puede usar.
  • INACTIVE: El dispositivo no está inscrito en el dominio.
  • RETURN_ARRIVED: Llegó la solicitud para reemplazar este dispositivo.
  • RETURN_REQUESTED: Se solicitó reemplazar este dispositivo.
  • SHIPPED: El dispositivo se envía desde el inventario de Google. (Obsoleta)
  • UNKNOWN: No se puede determinar el estado del dispositivo.
lastSync

string

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 YYYY-MM-DDThh:mm:ssTZD. Por ejemplo, 2010-04-05T17:30:04+01:00.

supportEndDate

string

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 YYYY-MM-DDThh:mm:ssTZD. Por ejemplo, 2010-04-05T17:30:04+01:00.

annotatedUser

string

El usuario del dispositivo indicado por el administrador. La longitud máxima es de 100 caracteres. Se permiten valores vacíos.

annotatedLocation

string

Es la dirección o ubicación del dispositivo que indique el administrador. La longitud máxima es de 200 caracteres. Se permiten valores vacíos.

notes

string

Notas sobre este dispositivo agregadas por el administrador. Esta propiedad se puede buscar con el parámetro query del método list. La longitud máxima es de 500 caracteres. Se permiten valores vacíos.

model

string

La información del modelo del dispositivo. Si el dispositivo no tiene esta información, esta propiedad no se incluye en la respuesta.

meid

string

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

string

Número de pedido del dispositivo Solo los dispositivos que se compraron directamente a Google tienen un número de pedido.

willAutoRenew

boolean

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

string

La versión del sistema operativo del dispositivo Chrome.

platformVersion

string

La versión de la plataforma del dispositivo Chrome.

firmwareVersion

string

La versión de firmware del dispositivo Chrome.

macAddress

string

La dirección MAC inalámbrica del dispositivo. Si el dispositivo no tiene esta información, no se incluye en la respuesta.

bootMode

string

Es el modo de inicio del dispositivo. Los siguientes son los valores posibles:

  • Verified: El dispositivo ejecuta una versión válida del Sistema operativo Chrome.
  • Dev: El interruptor de hardware del desarrollador del dispositivo está habilitado. Cuando se inicia, el dispositivo tiene una shell de línea de comandos. Para ver un ejemplo de cambio de desarrollador, consulta la información para desarrolladores de Chromebook.
lastEnrollmentTime

string

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 YYYY-MM-DDThh:mm:ssTZD. Por ejemplo, 2010-04-05T17:30:04+01:00. Para obtener más información sobre la inscripción automática y manual, consulta el Centro de ayuda de Chrome.

kind

string

Es el tipo de recurso. Para el recurso Chromeosdevices, el valor es admin#directory#chromeosdevice.

recentUsers[]

object

Una lista de los usuarios recientes del dispositivo, en orden descendente, por hora del último acceso.

recentUsers[].type

string

Es el tipo de usuario.

Los valores aceptables son:

  • USER_TYPE_MANAGED: El dominio administra al usuario.
  • USER_TYPE_UNMANAGED: El dominio no administra al usuario.
recentUsers[].email

string

La dirección de correo electrónico del usuario. Solo está presente si el tipo de usuario es USER_TYPE_MANAGED.

activeTimeRanges[]

object

Es una lista de los intervalos de tiempo activos (solo lectura).

activeTimeRanges[].activeTime

integer

Duración del uso en milisegundos.

activeTimeRanges[].date

string

Fecha de uso.

ethernetMacAddress

string

Es la dirección MAC del dispositivo en la interfaz de red Ethernet.

annotatedAssetId

string

Es el identificador de recursos que indica un administrador o que se especifica durante la inscripción.

etag

string

ETag del recurso.

diskVolumeReports[]

object

Informes de espacio en el disco y otra información sobre volúmenes activados o conectados

diskVolumeReports[].volumeInfo[]

object

Volúmenes de disco

diskVolumeReports[].volumeInfo[].volumeId

string

ID del volumen

diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

Espacio total en el disco [en bytes]

diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

Espacio libre en el disco [en bytes]

systemRamTotal

string (int64 format)

Total de RAM del dispositivo en bytes

cpuStatusReports[]

object

Informes de uso y temperatura de la CPU (solo lectura)

cpuStatusReports[].reportTime

string

Fecha y hora en que se recibió el informe.

cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer

cpuStatusReports[].cpuTemperatureInfo[]

object

Una lista de muestras de la temperatura de la CPU.

cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Temperatura en grados Celsius

cpuStatusReports[].cpuTemperatureInfo[].label

string

Etiqueta de la CPU

cpuInfo[]

object

Información sobre las especificaciones de CPU del dispositivo.

cpuInfo[].model

string

El nombre del modelo de CPU.

cpuInfo[].architecture

string

Arquitectura de la CPU

cpuInfo[].maxClockSpeedKhz

integer

La velocidad de reloj máxima de la CPU en kHz.

cpuInfo[].logicalCpus[]

object

Información para las CPU lógicas

cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Frecuencia máxima que puede ejecutarse la CPU, por política.

cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Frecuencia actual con la que se ejecuta la CPU.

cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Tiempo de inactividad desde el último inicio.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

cpuInfo[].logicalCpus[].cStates[]

object

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

string

Es el nombre del estado.

cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

Tiempo en el estado desde el último reinicio.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

deviceFiles[]

object

Lista de archivos del dispositivo para descargar (solo lectura)

deviceFiles[].name

string

Nombre del archivo

deviceFiles[].type

string

File type

deviceFiles[].downloadUrl

string

URL de descarga del archivo

deviceFiles[].createTime

string

Fecha y hora en que se creó el archivo

systemRamFreeReports[]

object

Informes de la cantidad de memoria RAM disponible (solo lectura).

systemRamFreeReports[].reportTime

string

Fecha y hora en que se recibió el informe.

systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)

lastKnownNetwork[]

object

Contiene la última red conocida (solo lectura)

lastKnownNetwork[].ipAddress

string

Es la dirección IP.

lastKnownNetwork[].wanIpAddress

string

La dirección IP de la WAN.

autoUpdateExpiration
(deprecated)

string (int64 format)

(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

string

(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

string

(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

string

(Solo lectura) Es la fecha en que se fabricó el dispositivo en formato aaaa-mm-dd.

orgUnitPath

string

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 /. 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.

tpmVersionInfo

object

Módulo de plataforma de confianza (TPM) (solo lectura)

tpmVersionInfo.family

string

TPM. Usamos la codificación de estilo TPM 2.0, por ejemplo:
TPM 1.2: “1.2” -> 312e3200
TPM 2.0: “2.0” -> 322e3000

tpmVersionInfo.specLevel

string

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

string

Código del fabricante del TPM.

tpmVersionInfo.tpmModel

string

Número de modelo del TPM.

tpmVersionInfo.firmwareVersion

string

Versión de firmware TPM.

tpmVersionInfo.vendorSpecific

string

Información específica del proveedor, como el ID del proveedor

screenshotFiles[]

object

Una lista de archivos de captura de pantalla para descargar. El tipo siempre es "SCREENSHOT_FILE". (solo lectura)

screenshotFiles[].name

string

Nombre del archivo

screenshotFiles[].type

string

File type

screenshotFiles[].downloadUrl

string

URL de descarga del archivo

screenshotFiles[].createTime

string

Fecha y hora en que se creó el archivo

orgUnitId

string

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

object (OsUpdateStatus)

El estado de las actualizaciones del SO del dispositivo.

firstEnrollmentTime

string

Fecha y hora de la primera vez que se inscribió el dispositivo.

lastDeprovisionTimestamp

string

(Solo lectura) Fecha y hora del último desaprovisionamiento del dispositivo.

deprovisionReason

enum (DeprovisionReason)

(Solo lectura) Motivo de desaprovisionamiento.

deviceLicenseType

enum (DeviceLicenseType)

Solo salida. Tipo de licencia del dispositivo.

backlightInfo[]

object (BacklightInfo)

Solo salida. Contiene información de retroiluminación del dispositivo.

autoUpdateThrough

string

Solo salida. La marca de tiempo después de la cual el dispositivo dejará de recibir actualizaciones o asistencia de Chrome.

extendedSupportEligible

boolean

Solo salida. Indica si el dispositivo requiere la habilitación de la asistencia extendida o no.

extendedSupportStart

string

Solo salida. Es la fecha del dispositivo en la que comienza la política de compatibilidad extendida para actualizaciones automáticas.

extendedSupportEnabled

boolean

Solo salida. Si la política de asistencia extendida está habilitada en el dispositivo

fanInfo[]

object (FanInfo)

Solo salida. Información del ventilador del dispositivo.

chromeOsType

enum (ChromeOsType)

Solo salida. Tipo de dispositivo con ChromeOS.

OsUpdateStatus

Contiene información sobre el estado actual de la actualización del SO.

Representación JSON
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Campos
state

enum (UpdateState)

El estado de actualización de una actualización del SO.

targetOsVersion

string

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

string

Nueva versión obligatoria de la plataforma de la aplicación de kiosco actualizada pendiente.

updateTime

string

Fecha y hora de la última actualización exitosa del SO.

updateCheckTime

string

Fecha y hora de la última búsqueda de actualizaciones.

rebootTime

string

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

string

Solo salida. Es la ruta a esta retroiluminación en el sistema. Es útil si el emisor necesita relacionarse con otra información.

maxBrightness

integer

Solo salida. Brillo máximo para la retroiluminación.

brightness

integer

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

integer

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

action
(deprecated)

En su lugar, usa BatchChangeChromeOsDeviceStatus.

get

Recupera las propiedades de un dispositivo con Sistema operativo Chrome.

list

Recupera una lista paginada de los dispositivos con Chrome OS de una cuenta.

moveDevicesToOu

Mueve o inserta varios dispositivos ChromeOS en una unidad organizativa.

patch

Actualiza las propiedades que se pueden actualizar de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.

update

Actualiza las propiedades que se pueden actualizar de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.