Recurso: ChromeOsDevice
Os dispositivos Google Chrome são executados no Chrome OS. Para mais informações sobre tarefas comuns da API, consulte o Guia do desenvolvedor.
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 ( |
Campos | |
---|---|
deviceId |
O ID exclusivo do dispositivo Chrome. |
serialNumber |
O número de série do dispositivo Chrome inserido quando o dispositivo foi ativado. Esse valor é igual ao Número de série do Admin Console na guia Dispositivos Chrome OS. |
status |
O status do dispositivo. Os valores aceitáveis são:
|
lastSync |
a data e a hora em que o dispositivo foi sincronizado pela última vez com as configurações da 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 |
supportEndDate |
A data final em que o dispositivo terá 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 |
annotatedUser |
O usuário do dispositivo, conforme observado pelo administrador. O tamanho máximo é de 100 caracteres. Valores vazios são permitidos. |
annotatedLocation |
O endereço ou local do dispositivo, conforme anotado pelo administrador. O nome deve ter no máximo |
notes |
Observações sobre este dispositivo adicionadas pelo administrador. Essa propriedade pode ser pesquisada com o parâmetro |
model |
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 |
O Identificador de Equipamento Móvel (MEID, na sigla em inglês) ou a Identificação Internacional de Equipamento Móvel (IMEI, na sigla em inglês) para o cartão móvel 3G em um dispositivo móvel. Um MEID/IMEI normalmente é usado ao adicionar um dispositivo ao plano de serviço pós-pago de uma operadora de telefonia. Se o dispositivo não tiver essas informações, essa propriedade não será incluída na resposta. Para obter mais informações sobre como exportar uma lista MEID/IMEI, consulte o Guia do desenvolvedor. |
orderNumber |
O número do pedido do dispositivo. Somente os dispositivos comprados diretamente do Google têm um número de pedido. |
willAutoRenew |
Determina se o dispositivo vai renovar o suporte automaticamente após a data de término do suporte. Esta é uma propriedade somente leitura. |
osVersion |
A versão do sistema operacional do dispositivo Chrome. |
platformVersion |
A versão da plataforma do dispositivo Chrome. |
firmwareVersion |
A versão do firmware do dispositivo Chrome. |
macAddress |
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 |
O modo de inicialização do dispositivo. Os valores possíveis são:
|
lastEnrollmentTime |
Data e 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 |
kind |
O tipo de recurso. Para o recurso Chromeosdevices, o valor é |
recentUsers[] |
Uma lista de usuários recentes do dispositivo, em ordem decrescente, pelo último horário de login. |
recentUsers[].type |
O tipo de usuário. Os valores aceitáveis são:
|
recentUsers[].email |
O endereço de e-mail do usuário. Isso só estará presente se o tipo de usuário for |
activeTimeRanges[] |
Uma lista de períodos ativos (somente leitura). |
activeTimeRanges[].activeTime |
Duração do uso em milissegundos. |
activeTimeRanges[].date |
Data de uso. |
ethernetMacAddress |
O endereço MAC do dispositivo na interface de rede Ethernet. |
annotatedAssetId |
O identificador de recursos, conforme anotado por um administrador ou especificado durante a inscrição. |
etag |
ETag do recurso. |
diskVolumeReports[] |
Relatórios de espaço em disco e outras informações sobre volumes montados/conectados. |
diskVolumeReports[].volumeInfo[] |
Volumes de disco |
diskVolumeReports[].volumeInfo[].volumeId |
Código do volume |
diskVolumeReports[].volumeInfo[].storageTotal |
Espaço total em disco [em bytes] |
diskVolumeReports[].volumeInfo[].storageFree |
Espaço livre em disco [em bytes] |
systemRamTotal |
Total de RAM no dispositivo em bytes |
cpuStatusReports[] |
Relatórios de utilização e temperatura da CPU (somente leitura) |
cpuStatusReports[].reportTime |
Data e hora em que o relatório foi recebido. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
Uma lista de amostras de temperatura da CPU. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Temperatura em graus Celsius. |
cpuStatusReports[].cpuTemperatureInfo[].label |
Rótulo da CPU |
cpuInfo[] |
Informações sobre as especificações da CPU no dispositivo. |
cpuInfo[].model |
O nome do modelo da CPU. |
cpuInfo[].architecture |
A arquitetura da CPU. |
cpuInfo[].maxClockSpeedKhz |
A velocidade máxima do clock da CPU em kHz. |
cpuInfo[].logicalCpus[] |
Informações sobre as CPUs lógicas |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Frequência máxima permitida de execução da CPU por política. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Frequência atual de execução da CPU. |
cpuInfo[].logicalCpus[].idleDuration |
Tempo de inatividade desde a última inicialização. Duração em segundos com até nove dígitos fracionários, terminando em " |
cpuInfo[].logicalCpus[].cStates[] |
Os estados C indicam o estado de consumo de energia da CPU. Para mais informações, consulte a documentação publicada pelo CPU maker. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Nome do estado. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Tempo gasto no estado desde a última reinicialização. Duração em segundos com até nove dígitos fracionários, terminando em " |
deviceFiles[] |
Uma lista de arquivos do dispositivo para download (somente leitura) |
deviceFiles[].name |
Nome do arquivo |
deviceFiles[].type |
Tipo de arquivo |
deviceFiles[].downloadUrl |
URL de download do arquivo |
deviceFiles[].createTime |
Data e hora em que o arquivo foi criado |
systemRamFreeReports[] |
Relatórios das quantidades de memória RAM disponível (somente leitura) |
systemRamFreeReports[].reportTime |
Data e hora em que o relatório foi recebido. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
Contém a última rede conhecida (somente leitura) |
lastKnownNetwork[].ipAddress |
O endereço IP. |
lastKnownNetwork[].wanIpAddress |
O endereço IP da WAN. |
autoUpdateExpiration |
(Somente leitura) O carimbo de data/hora após o qual o dispositivo deixará de receber atualizações ou suporte do Chrome. Use "autoUpdate Through" como alternativa. |
ethernetMacAddress0 |
Endereço MAC (somente leitura) usado pela porta Ethernet interna do Chromebook e para a interface de rede integrada (Ethernet). O formato é de 12 (doze) dígitos hexadecimais sem delimitador (letras maiúsculas). Isso só é relevante para alguns dispositivos. |
dockMacAddress |
(Somente leitura) Endereço MAC integrado da dock station a que o dispositivo se conectou. A configuração original define o endereço de controle de acesso à mídia (endereço MAC) atribuído para uso por uma base. Ele é reservado especificamente para a política de dispositivos de passagem MAC. O formato é de 12 (doze) dígitos hexadecimais sem delimitador (letras maiúsculas). Isso só é relevante para alguns dispositivos. |
manufactureDate |
(Somente leitura) A data em que o dispositivo foi fabricado no formato aaaa-mm-dd. |
orgUnitPath |
O caminho pai completo com o nome da unidade organizacional associada ao dispositivo. Os nomes de caminho 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, |
tpmVersionInfo |
Módulo de plataforma confiável (TPM, na sigla em inglês) (somente leitura) |
tpmVersionInfo.family |
família TPM. Usamos a codificação de estilo TPM 2.0, por exemplo: |
tpmVersionInfo.specLevel |
Nível de especificação do TPM. Consulte as especificações da biblioteca para o TPM 2.0 e as especificações principais do TPM 1.2. |
tpmVersionInfo.manufacturer |
Código do fabricante do TPM. |
tpmVersionInfo.tpmModel |
Número do modelo do TPM. |
tpmVersionInfo.firmwareVersion |
Versão do firmware do TPM. |
tpmVersionInfo.vendorSpecific |
Informações específicas do fornecedor, como o ID dele. |
screenshotFiles[] |
Uma lista de arquivos de captura de tela para download. O tipo sempre é "SCREENSHOT_FILE". (Somente leitura) |
screenshotFiles[].name |
Nome do arquivo |
screenshotFiles[].type |
Tipo de arquivo |
screenshotFiles[].downloadUrl |
URL de download do arquivo |
screenshotFiles[].createTime |
Data e hora em que o arquivo foi criado |
orgUnitId |
O ID exclusivo da unidade organizacional. "orgUnitPath" é a versão legível de "orgUnitId". Embora o "orgUnitPath" possa ser alterado com a renomeação de uma unidade organizacional no caminho, o "orgUnitId" não pode ser alterado para uma unidade organizacional. Essa propriedade pode ser atualizada por meio da API. Para mais informações sobre como criar uma estrutura organizacional para seu dispositivo, consulte a Central de Ajuda de administração. |
osUpdateStatus |
O status das atualizações do SO para o dispositivo. |
firstEnrollmentTime |
Data e hora da primeira vez que o dispositivo foi registrado. |
lastDeprovisionTimestamp |
(Somente leitura) Data e hora do último desprovisionamento do dispositivo. |
deprovisionReason |
(Somente leitura) Motivo do desprovisionamento. |
deviceLicenseType |
Apenas saída. Tipo de licença do dispositivo. |
backlightInfo[] |
Apenas saída. Contém informações sobre a luz de fundo do dispositivo. |
autoUpdateThrough |
Apenas saída. O carimbo de data/hora após o qual o dispositivo deixará de receber atualizações ou suporte do Chrome. |
extendedSupportEligible |
Apenas saída. Se o dispositivo exige ou não a ativação do suporte estendido. |
extendedSupportStart |
Apenas saída. Data do dispositivo em que a política de suporte estendido para atualizações automáticas começa. |
extendedSupportEnabled |
Apenas saída. Se a política de suporte estendido está ativada no dispositivo. |
fanInfo[] |
Apenas saída. Informações da ventilação do dispositivo. |
chromeOsType |
Apenas saída. Tipo de Chrome OS do dispositivo. |
OsUpdateStatus
Contém informações sobre o status atual da atualização do SO.
Representação JSON |
---|
{
"state": enum ( |
Campos | |
---|---|
state |
O estado de uma atualização do SO. |
targetOsVersion |
Nova versão da plataforma da imagem do SO que está sendo transferida por download e aplicada. Ele só é definido quando o status da atualização é UPDATE_STATUS_DOWNLOAD_IN_PROGRESS ou UPDATE_STATUS_NEED_REBOOT. Pode ser um "0.0.0.0" fictício para UPDATE_STATUS_NEED_REBOOT para alguns casos extremos, por exemplo, o mecanismo de atualização é reiniciado sem que seja necessário reinicializar. |
targetKioskAppVersion |
Nova versão de plataforma exigida do aplicativo de quiosque atualizado pendente. |
updateTime |
Data e hora da última atualização bem-sucedida do SO. |
updateCheckTime |
Data e hora da última verificação de atualização. |
rebootTime |
Data e hora da última reinicialização. |
UpdateState
O estado de uma atualização do SO.
Enums | |
---|---|
UPDATE_STATE_UNSPECIFIED |
O estado da atualização não foi especificado. |
UPDATE_STATE_NOT_STARTED |
Há uma atualização pendente, mas ela não foi iniciada. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
A atualização pendente está sendo baixada. |
UPDATE_STATE_NEED_REBOOT |
O dispositivo está pronto para instalar a atualização, mas precisa ser reiniciado. |
DeprovisionReason
O motivo do desprovisionamento de um dispositivo ChromeOS.
Enums | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
O motivo do desprovisionamento é desconhecido. |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
Substituição pelo mesmo modelo. Você tem uma autorização de devolução de materiais (ADM) ou está substituindo um dispositivo com defeito na garantia pelo mesmo modelo de dispositivo. |
DEPROVISION_REASON_UPGRADE |
O dispositivo foi atualizado. |
DEPROVISION_REASON_DOMAIN_MOVE |
O domínio do dispositivo foi alterado. |
DEPROVISION_REASON_SERVICE_EXPIRATION |
O serviço do dispositivo expirou. |
DEPROVISION_REASON_OTHER |
O dispositivo foi desprovisionado por um motivo legado que não é mais compatível. |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
Substituição por outro modelo. Você está substituindo este dispositivo por um modelo atualizado ou mais recente. |
DEPROVISION_REASON_RETIRING_DEVICE |
Saindo da tropa. Você está doando, descartando ou removendo o dispositivo do uso. |
DEPROVISION_REASON_UPGRADE_TRANSFER |
Transferência do upgrade do ChromeOS Flex. Este é um dispositivo ChromeOS Flex que você está substituindo por um Chromebook dentro de um ano. |
DEPROVISION_REASON_NOT_REQUIRED |
Não foi necessário informar um motivo. Por exemplo, as licenças foram devolvidas ao conjunto de licenças do cliente. |
DEPROVISION_REASON_REPAIR_CENTER |
O dispositivo foi desprovisionado pela central de serviços de reparo. Só pode ser definido pela Central de assistência técnica durante a ADM. |
DeviceLicenseType
O tipo de licença deste dispositivo.
Enums | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
O tipo da licença é desconhecido. |
ENTERPRISE |
O dispositivo vem com um Upgrade vitalício do Chrome Enterprise. |
ENTERPRISE_UPGRADE |
O dispositivo tem um Upgrade do Chrome Enterprise anual independente. |
EDUCATION_UPGRADE |
O dispositivo tem um Upgrade do Chrome Education independente vitalício. |
EDUCATION |
O dispositivo vem com um Upgrade vitalício do Chrome Education. |
KIOSK_UPGRADE |
O dispositivo tem um Upgrade de quiosque anual. |
BacklightInfo
Informações sobre as luzes de fundo do dispositivo.
Representação JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
Campos | |
---|---|
path |
Apenas saída. Caminho para essa luz de fundo no sistema. Útil se o autor da chamada precisar correlacionar com outras informações. |
maxBrightness |
Apenas saída. Brilho máximo para a luz de fundo. |
brightness |
Apenas saída. Brilho atual da luz de fundo, entre 0 e maxBrightness. |
FanInfo
Informações sobre a ventilação do dispositivo.
Representação JSON |
---|
{ "speedRpm": integer } |
Campos | |
---|---|
speedRpm |
Apenas saída. Velocidade da ventilação em RPM. |
ChromeOsType
Tipo de Chrome OS do dispositivo.
Enums | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
Tipo do ChromeOS não especificado. |
CHROME_OS_FLEX |
Chrome OS tipo Chrome OS Flex. |
CHROME_OS |
Tipo de Chrome OS: Chrome OS. |
Métodos |
|
---|---|
(deprecated) |
Use BatchChangeChromeOsDeviceStatus. |
|
Recupera as propriedades de um dispositivo Chrome OS. |
|
Recupera uma lista paginada de dispositivos Chrome OS dentro de uma conta. |
|
Move ou insere vários dispositivos Chrome OS em uma unidade organizacional. |
|
Atualiza as propriedades atualizáveis de um dispositivo, como annotatedUser , annotatedLocation , notes , orgUnitPath ou annotatedAssetId . |
|
Atualiza as propriedades atualizáveis de um dispositivo, como annotatedUser , annotatedLocation , notes , orgUnitPath ou annotatedAssetId . |