REST Resource: chromeosdevices

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 (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ]
}
Campos
deviceId

string

El ID único del dispositivo Chrome.

serialNumber

string

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

string

Es el 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. Un dispositivo PRE_PROVISIONED se puede borrar o mover a otra unidad organizativa. Una vez que se complete la inscripción, el dispositivo será 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 la caché del dispositivo. Si se vuelve a activar el dispositivo, se aplicará la configuración más reciente del sistema.
  • 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

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

annotatedUser

string

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

string

Es la dirección o ubicación del dispositivo según lo 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

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

string

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

string

Es 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 su 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 incluirá 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 un shell de línea de comandos. Para ver un ejemplo de un interruptor de desarrollador, consulta la información para desarrolladores de Chromebook.
lastEnrollmentTime

string

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 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 usuarios recientes de dispositivos, en orden descendente, según 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

Una lista de períodos de tiempo activos (solo lectura).

activeTimeRanges[].activeTime

integer

Es la duración del uso, expresada en milisegundos.

activeTimeRanges[].date

string

Fecha de uso

ethernetMacAddress

string

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

annotatedAssetId

string

El identificador de recursos tal como lo indica un administrador o 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 de CPU y temperatura (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 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

El nombre del modelo de la CPU.

cpuInfo[].architecture

string

La arquitectura de la CPU

cpuInfo[].maxClockSpeedKhz

integer

Es la velocidad máxima del reloj de la CPU en kHz.

cpuInfo[].logicalCpus[]

object

Información de las CPU lógicas

cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Frecuencia máxima de ejecución de la CPU (según la 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 terminen 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 que publicó 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 dedicó al estado desde el último reinicio.

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

deviceFiles[]

object

Una lista de los archivos del dispositivo para descargar (solo lectura)

deviceFiles[].name

string

Nombre del archivo

deviceFiles[].type

string

File type

deviceFiles[].downloadUrl

string

URL de descarga de archivos

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

Indica la dirección IP.

lastKnownNetwork[].wanIpAddress

string

Es la dirección IP de WAN.

autoUpdateExpiration

string (int64 format)

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

ethernetMacAddress0

string

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

string

(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

string

(Solo lectura) Es la fecha en la 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. Si quieres obtener más información para crear una estructura organizativa para el dispositivo, consulta el Centro de ayuda para administradores.

tpmVersionInfo

object

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

tpmVersionInfo.family

string

Familia 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

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

Es el código del fabricante del TPM.

tpmVersionInfo.tpmModel

string

Número de modelo del TPM.

tpmVersionInfo.firmwareVersion

string

Versión del firmware del TPM.

tpmVersionInfo.vendorSpecific

string

Información específica del proveedor, como su ID.

screenshotFiles[]

object

Una lista de los archivos de captura de pantalla que se descargarán. 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 de archivos

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

object (OsUpdateStatus)

Es el estado de las actualizaciones del SO del dispositivo.

firstEnrollmentTime

string

Indica la 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)

Motivo de desaprovisionamiento (solo lectura).

deviceLicenseType

enum (DeviceLicenseType)

Solo salida. Tipo de licencia del dispositivo.

backlightInfo[]

object (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 (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Campos
state

enum (UpdateState)

Es el estado 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 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

string

Nueva versión obligatoria de la plataforma desde la aplicación de kiosco con actualización pendiente.

updateTime

string

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

updateCheckTime

string

Fecha y hora de la última verificación de actualizaciones.

rebootTime

string

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

string

Solo salida. Ruta a esta retroiluminación en el sistema. Es útil si el llamador necesita correlacionarse 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

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