REST Resource: chromeosdevices

Recurso: ChromeOsDevice

Los dispositivos de Google Chrome se ejecutan en el Sistema operativo Chrome. 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 (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),
  "diskSpaceUsage": {
    object (ByteUsage)
  }
}
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

Es el estado del dispositivo.

Los valores aceptables son:

  • ACTIVE: El dispositivo está inscrito en el dominio.
  • DELINQUENT: La licencia anual del dominio venció y el dispositivo ya no recibe políticas ni parámetros de configuración. Cuando se compra una licencia nueva, el dispositivo vuelve al estado ACTIVE.
  • PRE_PROVISIONED: El dispositivo se registró para la inscripción automática. Un dispositivo PRE_PROVISIONED se puede mover a otra unidad organizativa o borrar. Una vez que se complete la inscripción, el dispositivo tendrá el estado ACTIVE.
  • DEPROVISIONED: El dispositivo ya no es apto para inscribirse en el dominio. Se canceló el pedido. La configuración del dispositivo se almacenó en caché en el dispositivo. Si se vuelve a activar el dispositivo, se aplicará la configuración del sistema más reciente 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 realizó una solicitud para 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

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

string

Es la fecha final en la que se admitirá el dispositivo. Esto solo se aplica a los dispositivos que se compraron directamente a 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 YYYY-MM-DDThh:mm:ssTZD. Por ejemplo, 2010-04-05T17:30:04+01:00.
annotatedUser

string

Es el usuario del dispositivo que anota el administrador. La longitud máxima es de 100 caracteres. Se permiten valores vacíos.
annotatedLocation

string

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

string

Son las notas sobre este dispositivo que agregó el administrador. Se puede buscar esta propiedad 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

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 al plan de servicio pospago de un operador inalámbrico. Si el dispositivo no tiene esta información, esta propiedad no se incluye en la respuesta. Para obtener más información sobre cómo exportar una lista de MEID o IMEI, consulta la Guía para desarrolladores.
orderNumber

string

El 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

Es 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 SO Chrome.
  • Dev: El interruptor de hardware para desarrolladores del dispositivo está habilitado. Cuando se inicia, el dispositivo tiene una shell de línea de comandos. Para ver un ejemplo de un interruptor para desarrolladores, 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 formato de fecha y hora ISO 8601. La hora es la fecha completa más horas, minutos y segundos en el formato 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

El tipo de recurso. Para el recurso Chromeosdevices, el valor es admin#directory#chromeosdevice.
recentUsers[]

object

Una lista de usuarios recientes del dispositivo, en orden descendente, por la 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 (de solo lectura).
activeTimeRanges[].activeTime

integer

Es la duración del uso, expresada 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

El identificador de recurso que anota 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 los volúmenes activados o conectados.
diskVolumeReports[].volumeInfo[]

object

Volúmenes de disco
diskVolumeReports[].volumeInfo[].volumeId

string

ID de 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)

Es la RAM total 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 aviso.
cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer
cpuStatusReports[].cpuTemperatureInfo[]

object

Una lista de muestras de 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 la CPU del dispositivo
cpuInfo[].model

string

Es el nombre del modelo de la CPU.
cpuInfo[].architecture

string

La arquitectura de la CPU
cpuInfo[].maxClockSpeedKhz

integer

Es la velocidad máxima de reloj de la CPU en kHz.
cpuInfo[].logicalCpus[]

object

Información de las CPUs lógicas
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Es la frecuencia máxima a la que se permite que se ejecute la CPU, según la política.
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Es la frecuencia actual a la que se ejecuta la CPU.
cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Tiempo inactivo 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 que se pasó 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

Es una lista de archivos de dispositivos para descargar (de 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 (de solo lectura)
systemRamFreeReports[].reportTime

string

Fecha y hora en que se recibió el aviso.
systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)
lastKnownNetwork[]

object

Contiene la última red conocida (de solo lectura)
lastKnownNetwork[].ipAddress

string

La dirección IP.
lastKnownNetwork[].wanIpAddress

string

La dirección IP de la WAN
autoUpdateExpiration
(deprecated)

string (int64 format)

(Solo lectura) Es la marca de tiempo a partir de la cual el dispositivo dejará de recibir actualizaciones o asistencia de Chrome. En su lugar, usa "autoUpdateThrough".
ethernetMacAddress0

string

Es la dirección MAC (de solo lectura) que usa el puerto Ethernet interno de la Chromebook y para la interfaz de red (Ethernet) integrada. El formato es de doce (12) dígitos hexadecimales sin delimitadores (letras mayúsculas). Esto solo es relevante para algunos dispositivos.
dockMacAddress

string

Dirección MAC integrada (de solo lectura) de la estación de carga 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 que la use una estación de carga. Se reserva específicamente para la política de dispositivos de transferencia de MAC. El formato es de doce (12) dígitos hexadecimales sin delimitadores (letras mayúsculas). Esto solo es relevante para algunos dispositivos.
manufactureDate

string

(Solo lectura) Es la fecha de fabricación del dispositivo en formato aaaa-mm-dd.
orgUnitPath

string

Es la ruta de acceso superior completa con el nombre de la unidad organizativa asociada con el dispositivo. Los nombres de las rutas no distinguen mayúsculas de minúsculas. Si la unidad organizativa superior es la organización de nivel superior, se representa como 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

Familia de TPM. Usamos la codificación de estilo TPM 2.0, p.ej.:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000
tpmVersionInfo.specLevel

string

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

string

Código del fabricante del TPM
tpmVersionInfo.tpmModel

string

Número de modelo del TPM.
tpmVersionInfo.firmwareVersion

string

Versión de firmware del TPM
tpmVersionInfo.vendorSpecific

string

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

object

Una lista de archivos de capturas 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

El ID único de la unidad organizativa. orgUnitPath es la versión legible por humanos 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 de administración.
osUpdateStatus

object (OsUpdateStatus)

Es 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 de la última baja del dispositivo.
deprovisionReason

enum (DeprovisionReason)

(Solo lectura) Motivo del desaprovisionamiento.
deviceLicenseType

enum (DeviceLicenseType)

Solo salida. Tipo de licencia del dispositivo.
backlightInfo[]

object (BacklightInfo)

Solo salida. Contiene información sobre la retroiluminación del dispositivo.
autoUpdateThrough

string

Solo salida. Es la marca de tiempo a partir de la cual el dispositivo dejará de recibir actualizaciones o asistencia de Chrome.
extendedSupportEligible

boolean

Solo salida. Indica si el dispositivo requiere la aceptación de la compatibilidad extendida.
extendedSupportStart

string

Solo salida. Es la fecha del dispositivo cuando comienza la política de asistencia extendida para las actualizaciones automáticas.
extendedSupportEnabled

boolean

Solo salida. Indica 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. Es el tipo de ChromeOS del dispositivo.
diskSpaceUsage

object (ByteUsage)

Solo salida. Indica la cantidad de espacio en el disco que tiene disponible el dispositivo y que está usando actualmente.

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)

Es el estado de actualización de una actualización del SO.
targetOsVersion

string

Es la nueva versión de la plataforma de la imagen del SO que se descarga y 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 "0.0.0.0" ficticio para UPDATE_STATUS_NEED_REBOOT en algunos casos extremos, p.ej., si el motor de actualización se reinicia sin un reinicio.
targetKioskAppVersion

string

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

string

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

string

Fecha y hora de la última verificación de actualización.
rebootTime

string

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 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 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 una autorización de devolución de materiales (ADP) 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 del dispositivo venció.
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 requirió 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 ADP.

DeviceLicenseType

Es 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 tiene una actualización anual independiente de Chrome Enterprise.
EDUCATION_UPGRADE El dispositivo tiene una actualización de Chrome Education independiente y perpetua.
EDUCATION El dispositivo incluye una actualización de Chrome Education perpetua.
KIOSK_UPGRADE El dispositivo tiene una actualización anual de Kiosk.

BacklightInfo

Información sobre la luz de fondo del dispositivo.

Representación JSON 
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
Campos
path

string

Solo salida. Es la ruta de acceso a esta retroiluminación en el sistema. Es útil si el llamador necesita correlacionar con otra información.
maxBrightness

integer

Solo salida. Es el brillo máximo de la retroiluminación.
brightness

integer

Solo salida. Es el 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

Es el tipo de ChromeOS del dispositivo.

Enumeraciones
CHROME_OS_TYPE_UNSPECIFIED No se especificó el tipo de ChromeOS.
CHROME_OS_FLEX ChromeOS: Escribe ChromeOS Flex.
CHROME_OS ChromeOS: Escribe ChromeOS.

ByteUsage

Representa una capacidad de datos con una cantidad de uso actual en bytes.

Representación JSON 
{
  "capacityBytes": string,
  "usedBytes": string
}
Campos
capacityBytes

string (int64 format)

Solo salida. Es el valor de la capacidad total, en bytes.
usedBytes

string (int64 format)

Solo salida. Es el valor de uso actual, en bytes.

Métodos

action
(deprecated)

 En su lugar, usa BatchChangeChromeOsDeviceStatus.

get

 Recupera las propiedades de un dispositivo ChromeOS.

list

 Recupera una lista paginada de dispositivos ChromeOS dentro de una cuenta.

moveDevicesToOu

 Mueve o inserta varios dispositivos ChromeOS en una unidad organizativa.

patch

 Actualiza las propiedades actualizables de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.

update

 Actualiza las propiedades actualizables de un dispositivo, como annotatedUser, annotatedLocation, notes, orgUnitPath o annotatedAssetId.