REST Resource: chromeosdevices

Recurso: ChromeOsDevice

Os dispositivos Google Chrome funcionam com o Chrome OS. Para mais informações sobre tarefas comuns da API, consulte o Guia para desenvolvedores.

Representação 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)
  },
  "osVersionCompliance": enum (Compliance)
}
Campos
deviceId

string

O ID exclusivo do dispositivo Chrome.
serialNumber

string

O número de série do dispositivo Chrome inserido quando ele foi ativado. Esse valor é o mesmo que o Número de série do Admin Console na guia Dispositivos Chrome OS.
status

string

O status do dispositivo.

Os valores aceitáveis são:

  • ACTIVE: o dispositivo está registrado no domínio.
  • DELINQUENT: a licença anual do domínio expirou, e o dispositivo não recebe mais políticas e configurações. Quando uma nova licença é comprada, o dispositivo volta ao estado ACTIVE.
  • PRE_PROVISIONED: o dispositivo foi registrado no registro sem toque. Um dispositivo PRE_PROVISIONED pode ser movido para outra unidade organizacional ou excluído. Quando o registro for concluído, o dispositivo vai estar ACTIVE.
  • DEPROVISIONED: o dispositivo não está mais qualificado para ser registrado no domínio. O pedido foi cancelado. As configurações do dispositivo foram armazenadas em cache no aparelho. Se o dispositivo for ativado novamente, as configurações de sistema mais recentes serão aplicadas a ele.
  • DISABLED: o dispositivo foi desativado pelo administrador e não pode ser usado.
  • INACTIVE: o dispositivo não está registrado no domínio.
  • RETURN_ARRIVED: o pedido para substituir este dispositivo chegou.
  • RETURN_REQUESTED: foi feita uma solicitação para substituir este dispositivo.
  • SHIPPED: o dispositivo é enviado do inventário do Google. (descontinuado)
  • UNKNOWN: não foi possível determinar o status do dispositivo.
lastSync

string

Data e hora da última sincronização do dispositivo com as configurações de política no Admin Console. O valor está no formato de data e hora ISO 8601. A hora é a data completa mais horas, minutos e segundos no formato YYYY-MM-DDThh:mm:ssTZD. Por exemplo, 2010-04-05T17:30:04+01:00.
supportEndDate

string

A data final em que o dispositivo vai receber suporte. Isso se aplica apenas aos dispositivos comprados diretamente do Google. O valor está no formato de data e hora ISO 8601. A hora é a data completa mais horas, minutos e segundos no formato YYYY-MM-DDThh:mm:ssTZD. Por exemplo, 2010-04-05T17:30:04+01:00.
annotatedUser

string

O usuário do dispositivo conforme anotado pelo administrador. O tamanho máximo é de 100 caracteres. Valores vazios são permitidos.
annotatedLocation

string

O endereço ou local do dispositivo conforme anotado pelo administrador. O nome deve ter no máximo 200 caracteres. Valores vazios são permitidos.
notes

string

Observações sobre este dispositivo adicionadas pelo administrador. Essa propriedade pode ser pesquisada com o parâmetro query do método list. O tamanho máximo é de 500 caracteres. Valores vazios são permitidos.
model

string

As informações do modelo do dispositivo. Se o dispositivo não tiver essas informações, essa propriedade não será incluída na resposta.
meid

string

O identificador de equipamento móvel (MEID) ou a identificação internacional de equipamento móvel (IMEI) do cartão móvel 3G em um dispositivo móvel. Um MEID/IMEI normalmente é usado ao adicionar um dispositivo a um plano de serviço pós-pago de uma operadora sem fio. Se o dispositivo não tiver essas informações, essa propriedade não será incluída na resposta. Para mais informações sobre como exportar uma lista de MEID/IMEI, consulte o Guia do desenvolvedor.
orderNumber

string

O número do pedido do dispositivo. Somente os dispositivos comprados diretamente do Google têm um número de pedido.
willAutoRenew

boolean

Determina se o dispositivo vai renovar automaticamente o suporte após a data de término. Essa é uma propriedade somente leitura.
osVersion

string

A versão do sistema operacional do dispositivo Chrome.
platformVersion

string

A versão da plataforma do dispositivo Chrome.
firmwareVersion

string

A versão do firmware do dispositivo Chrome.
macAddress

string

O endereço MAC sem fio do dispositivo. Se o dispositivo não tiver essas informações, elas não serão incluídas na resposta.
bootMode

string

O modo de inicialização do dispositivo. Os valores possíveis são:

  • Verified: o dispositivo está executando uma versão válida do Chrome OS.
  • Dev: a chave de hardware para desenvolvedores do dispositivo está ativada. Ao inicializar, o dispositivo tem um shell de linha de comando. Para ver um exemplo de troca de desenvolvedor, consulte as informações para desenvolvedores do Chromebook.
lastEnrollmentTime

string

A data e a hora em que o dispositivo foi registrado pela última vez. O valor está no formato de data e hora ISO 8601. A hora é a data completa mais horas, minutos e segundos no formato YYYY-MM-DDThh:mm:ssTZD. Por exemplo, 2010-04-05T17:30:04+01:00. Para mais informações sobre o registro automático e manual, consulte a Central de Ajuda do Chrome.
kind

string

O tipo de recurso. Para o recurso "chromeosdevices", o valor é admin#directory#chromeosdevice.
recentUsers[]

object

Uma lista dos usuários recentes do dispositivo, em ordem decrescente, pelo horário do último login.
recentUsers[].type

string

O tipo de usuário.

Os valores aceitáveis são:

  • USER_TYPE_MANAGED: o usuário é gerenciado pelo domínio.
  • USER_TYPE_UNMANAGED: o usuário não é gerenciado pelo domínio.
recentUsers[].email

string

O endereço de e-mail do usuário. Isso só vai estar presente se o tipo de usuário for USER_TYPE_MANAGED.
activeTimeRanges[]

object

Uma lista de períodos ativos (somente leitura).
activeTimeRanges[].activeTime

integer

Duração do uso em milissegundos.
activeTimeRanges[].date

string

Data de uso.
ethernetMacAddress

string

O endereço MAC do dispositivo na interface de rede Ethernet.
annotatedAssetId

string

O identificador de recursos conforme anotado por um administrador ou especificado durante a inscrição.
etag

string

ETag do recurso.
diskVolumeReports[]

object

Relatórios de espaço em disco e outras informações sobre volumes montados/conectados.
diskVolumeReports[].volumeInfo[]

object

Volumes de disco
diskVolumeReports[].volumeInfo[].volumeId

string

ID do volume
diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

Espaço total em disco [em bytes]
diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

Espaço livre em disco [em bytes]
systemRamTotal

string (int64 format)

Total de RAM no dispositivo em bytes
cpuStatusReports[]

object

Relatórios de utilização e temperatura da CPU (somente leitura)
cpuStatusReports[].reportTime

string

Data e hora em que a denúncia foi recebida.
cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer
cpuStatusReports[].cpuTemperatureInfo[]

object

Uma lista de amostras de temperatura da CPU.
cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Temperatura em graus Celsius.
cpuStatusReports[].cpuTemperatureInfo[].label

string

Marcador da CPU
cpuInfo[]

object

Informações sobre as especificações da CPU no dispositivo.
cpuInfo[].model

string

O nome do modelo da CPU.
cpuInfo[].architecture

string

A arquitetura da CPU.
cpuInfo[].maxClockSpeedKhz

integer

A velocidade máxima do clock da CPU em kHz.
cpuInfo[].logicalCpus[]

object

Informações sobre as CPUs lógicas
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Frequência máxima em que a CPU pode ser executada, por política.
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

Frequência atual em que a CPU está sendo executada.
cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Tempo ocioso desde a última inicialização.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
cpuInfo[].logicalCpus[].cStates[]

object

Os estados C indicam o estado de consumo de energia da CPU. Para mais informações, consulte a documentação publicada pelo fabricante da CPU.
cpuInfo[].logicalCpus[].cStates[].displayName

string

Nome do estado.
cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

Tempo gasto no estado desde a última reinicialização.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
deviceFiles[]

object

Uma lista de arquivos de dispositivos para baixar (somente leitura)
deviceFiles[].name

string

Nome do arquivo
deviceFiles[].type

string

Tipo de arquivo
deviceFiles[].downloadUrl

string

URL de download do arquivo
deviceFiles[].createTime

string

Data e hora em que o arquivo foi criado
systemRamFreeReports[]

object

Relatórios de quantidades de memória RAM disponível (somente leitura)
systemRamFreeReports[].reportTime

string

Data e hora em que a denúncia foi recebida.
systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)
lastKnownNetwork[]

object

Contém a última rede conhecida (somente leitura).
lastKnownNetwork[].ipAddress

string

O endereço IP.
lastKnownNetwork[].wanIpAddress

string

O endereço IP da WAN.
autoUpdateExpiration
(deprecated)

string (int64 format)

(Somente leitura) O carimbo de data/hora após o qual o dispositivo vai parar de receber atualizações ou suporte do Chrome. Use "autoUpdateThrough".
ethernetMacAddress0

string

(Somente leitura) Endereço MAC usado pela porta Ethernet interna do Chromebook e pela interface de rede (Ethernet) integrada. O formato é de 12 dígitos hexadecimais sem delimitador (letras maiúsculas). Isso só é relevante para alguns dispositivos.
dockMacAddress

string

(Somente leitura) Endereço MAC integrado da docking station a que o dispositivo está conectado. A fábrica define o endereço de controle de acesso à mídia (MAC) atribuído para uso por uma dock. Ele é reservado especificamente para a política de dispositivo de passagem de MAC. O formato é de 12 dígitos hexadecimais sem delimitador (letras maiúsculas). Isso só é relevante para alguns dispositivos.
manufactureDate

string

(Somente leitura) A data de fabricação do dispositivo no formato aaaa-mm-dd.
orgUnitPath

string

O caminho completo da unidade mãe com o nome da unidade organizacional associada ao dispositivo. Os nomes de caminhos não diferenciam maiúsculas de minúsculas. Se a unidade organizacional mãe for a organização de nível superior, ela será representada como uma barra, /. Essa propriedade pode ser atualizada usando a API. Para mais informações sobre como criar uma estrutura organizacional para seu dispositivo, consulte a Central de Ajuda para administradores.
tpmVersionInfo

object

Trusted Platform Module (TPM) (somente leitura)
tpmVersionInfo.family

string

Família TPM. Usamos a codificação no estilo TPM 2.0, por exemplo:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000
tpmVersionInfo.specLevel

string

Nível de especificação do TPM. Consulte a especificação da biblioteca para TPM 2.0 e a especificação principal para TPM 1.2.
tpmVersionInfo.manufacturer

string

Código do fabricante do TPM.
tpmVersionInfo.tpmModel

string

Número do modelo do TPM.
tpmVersionInfo.firmwareVersion

string

Versão do firmware do TPM.
tpmVersionInfo.vendorSpecific

string

Informações específicas do fornecedor, como ID do fornecedor.
screenshotFiles[]

object

Uma lista de arquivos de captura de tela para baixar. O tipo é sempre "SCREENSHOT_FILE". (Somente leitura)
screenshotFiles[].name

string

Nome do arquivo
screenshotFiles[].type

string

Tipo de arquivo
screenshotFiles[].downloadUrl

string

URL de download do arquivo
screenshotFiles[].createTime

string

Data e hora em que o arquivo foi criado
orgUnitId

string

O ID exclusivo da unidade organizacional. "orgUnitPath" é a versão legível por humanos de "orgUnitId". Embora orgUnitPath possa mudar ao renomear uma unidade organizacional no caminho, orgUnitId não pode ser alterado para uma unidade organizacional. Essa propriedade pode ser atualizada usando a API. Para mais informações sobre como criar uma estrutura organizacional para seu dispositivo, consulte a Central de Ajuda para administradores.
osUpdateStatus

object (OsUpdateStatus)

O status das atualizações do SO para o dispositivo.
firstEnrollmentTime

string

Data e hora da primeira vez em que o dispositivo foi registrado.
lastDeprovisionTimestamp

string

(Somente leitura) Data e hora do último cancelamento do provisionamento do dispositivo.
deprovisionReason

enum (DeprovisionReason)

(Somente leitura) Motivo do desprovisionamento.
deviceLicenseType

enum (DeviceLicenseType)

Apenas saída. Tipo de licença do dispositivo.
backlightInfo[]

object (BacklightInfo)

Apenas saída. Contém informações sobre a luz de fundo do dispositivo.
autoUpdateThrough

string

Apenas saída. O carimbo de data/hora após o qual o dispositivo vai parar de receber atualizações ou suporte do Chrome.
extendedSupportEligible

boolean

Apenas saída. Se o dispositivo precisa ou não ativar o suporte estendido.
extendedSupportStart

string

Apenas saída. Data do dispositivo em que a política de suporte estendido para atualizações automáticas começa.
extendedSupportEnabled

boolean

Apenas saída. Se a política de suporte estendido está ativada no dispositivo.
fanInfo[]

object (FanInfo)

Apenas saída. Informações sobre o ventilador do dispositivo.
chromeOsType

enum (