- Recurso: TelemetryDevice
- CpuInfo
- Arquitetura
- CpuStatusReport
- CpuTemperatureInfo
- MemoryInfo
- TotalMemoryEncryptionInfo
- MemoryEncryptionState
- MemoryEncryptionAlgorithm
- MemoryStatusReport
- NetworkInfo
- NetworkDevice
- NetworkDeviceType
- NetworkStatusReport
- NetworkType
- NetworkDiagnosticsReport
- OsUpdateStatus
- UpdateState
- GraphicsInfo
- GraphicsAdapterInfo
- DisplayDevice
- TouchScreenInfo
- TouchScreenDevice
- GraphicsStatusReport
- DisplayInfo
- BatteryInfo
- BatteryStatusReport
- BatterySampleReport
- BatteryHealth
- StorageInfo
- DiskVolume
- StorageStatusReport
- DiskInfo
- ThunderboltInfo
- ThunderboltSecurityLevel
- BootPerformanceReport
- ShutdownReason
- HeartbeatStatusReport
- Estado
- KioskAppStatusReport
- RuntimeCountersReport
- Métodos
Recurso: TelemetryDevice
Dados de telemetria coletados em um dispositivo gerenciado.
- Permissão granular necessária: TELEMETRY_API_DEVICE
| Representação JSON | 
|---|
| { "name": string, "customer": string, "orgUnitId": string, "deviceId": string, "serialNumber": string, "cpuInfo": [ { object ( | 
| Campos | |
|---|---|
| name | 
 Apenas saída. Nome do recurso do dispositivo. | 
| customer | 
 Apenas saída. Cliente do Google Workspace que registrou o dispositivo na empresa. | 
| orgUnitId | 
 Apenas saída. ID da unidade organizacional do dispositivo. | 
| deviceId | 
 Apenas saída. O ID exclusivo da API Directory do dispositivo. Esse valor é o mesmo do ID da API Directory do Admin Console na guia "Dispositivos ChromeOS". | 
| serialNumber | 
 Apenas saída. Número de série do dispositivo. Esse valor é igual ao número de série do Admin Console na guia "Dispositivos ChromeOS". | 
| cpuInfo[] | 
 Apenas saída. Informações sobre as especificações de CPU do dispositivo. | 
| cpuStatusReport[] | 
 Apenas saída. Relatórios de status da CPU coletados periodicamente e classificados em ordem decrescente de  | 
| memoryInfo | 
 Apenas saída. Informações sobre as especificações de memória do dispositivo. | 
| memoryStatusReport[] | 
 Apenas saída. Relatórios de status de memória coletados periodicamente, classificados em ordem decrescente por  | 
| networkInfo | 
 Apenas saída. Informações sobre os dispositivos de rede. | 
| networkStatusReport[] | 
 Apenas saída. Especificações de rede coletadas periodicamente. | 
| networkDiagnosticsReport[] | 
 Apenas saída. Diagnósticos de rede coletados periodicamente. | 
| osUpdateStatus[] | 
 Apenas saída. Contém informações relevantes sobre o status da atualização do ChromeOS. | 
| graphicsInfo | 
 Apenas saída. Contém informações sobre periféricos gráficos para o dispositivo. | 
| graphicsStatusReport[] | 
 Apenas saída. Relatórios gráficos coletados periodicamente. | 
| batteryInfo[] | 
 Apenas saída. Informações sobre as especificações da bateria do dispositivo. | 
| batteryStatusReport[] | 
 Apenas saída. Relatórios de bateria coletados periodicamente. | 
| storageInfo | 
 Apenas saída. Informações sobre as especificações de armazenamento do dispositivo. | 
| storageStatusReport[] | 
 Apenas saída. Relatórios de armazenamento coletados periodicamente. | 
| thunderboltInfo[] | 
 Apenas saída. Informações sobre o barramento Thunderbolt. | 
| audioStatusReport[] | 
 Apenas saída. Relatórios de áudio coletados periodicamente e classificados em ordem decrescente de  | 
| bootPerformanceReport[] | 
 Apenas saída. Relatórios de desempenho de inicialização do dispositivo. | 
| heartbeatStatusReport[] | 
 Apenas saída. Relatório de status de batimento cardíaco com carimbos de data/hora classificados periodicamente em ordem decrescente de  | 
| kioskAppStatusReport[] | 
 Apenas saída. Relatório de status do app quiosque para o dispositivo de quiosque | 
| networkBandwidthReport[] | 
 Apenas saída. Relatórios de largura de banda da rede coletados periodicamente e classificados em ordem decrescente de  | 
| peripheralsReport[] | 
 Apenas saída. Relatórios de periféricos coletados periodicamente, classificados em ordem decrescente de  | 
| appReport[] | 
 Apenas saída. Relatórios de app coletados periodicamente e classificados em ordem decrescente de  | 
| runtimeCountersReport[] | 
 Apenas saída. Os contadores de tempo de execução coletam o tempo de execução do dispositivo e as contagens de transições S0->S3, S0->S4 e S0->S5, ou seja, a entrada nos estados de suspensão, hibernação e desligamento | 
CpuInfo
Especificações da CPU do dispositivo
- Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
- Os dados desse campo são controlados pela política: ReportDeviceCpuInfo
- Frequência de coleta de dados: somente no upload
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_CPU_INFO
| Representação JSON | 
|---|
| {
  "model": string,
  "architecture": enum ( | 
| Campos | |
|---|---|
| model | 
 Apenas saída. O nome do modelo da CPU. Exemplo: CPU Intel(R) Core(TM) i5-8250U a 1,60 GHz | 
| architecture | 
 Apenas saída. Tipo de arquitetura da CPU. 
 | 
| maxClockSpeed | 
 Apenas saída. A velocidade máxima do clock da CPU em kHz. | 
| keylockerSupported | 
 Apenas saída. Se o Key Locker é compatível. | 
| keylockerConfigured | 
 Apenas saída. Se o Key Locker está configurado. | 
Arquitetura
Tipo de arquitetura da CPU.
| Enums | |
|---|---|
| ARCHITECTURE_UNSPECIFIED | Arquitetura desconhecida. | 
| X64 | Arquitetura x64 | 
CpuStatusReport
Fornece informações sobre o status da CPU.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceCpuInfo
- Frequência de coleta de dados: a cada 10 minutos
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_CPU_REPORT
| Representação JSON | 
|---|
| {
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object ( | 
| Campos | |
|---|---|
| reportTime | 
 Apenas saída. O carimbo de data/hora em milissegundos que representa o momento em que esse relatório foi amostrado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| sampleFrequency | 
 Apenas saída. Frequência da amostragem do relatório. Duração em segundos com até nove dígitos fracionários, terminando em " | 
| cpuUtilizationPct | 
 Apenas saída. Exemplo de utilização da CPU (0 a 100%). | 
| cpuTemperatureInfo[] | 
 Apenas saída. Informações de amostra da temperatura da CPU por núcleo em graus Celsius | 
CpuTemperatureInfo
Temperatura da CPU de um dispositivo. Amostras coletadas por núcleo da CPU em graus Celsius.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceCpuInfo
- Frequência de coleta de dados: a cada 10 minutos
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
| Representação JSON | 
|---|
| { "temperatureCelsius": integer, "label": string } | 
| Campos | |
|---|---|
| temperatureCelsius | 
 Apenas saída. Temperatura da CPU em graus Celsius. | 
| label | 
 Apenas saída. Rótulo da CPU. Exemplo: núcleo 0 | 
MemoryInfo
Informações de memória de um dispositivo.
- Esse campo tem informações de telemetria e do dispositivo:
            - totalRamBytes: informações do dispositivo
- availableRamBytes: informações de telemetria
- totalMemoryEncryption: informações do dispositivo
 
- Os dados desse campo são controlados pela política: ReportDeviceMemoryInfo.
- Frequência da coleta de dados:
            - totalRamBytes: somente no upload
- availableRamBytes: a cada 10 minutos
- totalMemoryEncryption: na inicialização do dispositivo
 
- Frequência padrão de relatórios de dados:
            - totalRamBytesa 3 horas
- availableRamBytesa 3 horas
- totalMemoryEncryption: na inicialização do dispositivo
- Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: somente para totalMemoryEncryption
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_MEMORY_INFO
| Representação JSON | 
|---|
| {
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object ( | 
| Campos | |
|---|---|
| totalRamBytes | 
 Apenas saída. RAM total em bytes. | 
| availableRamBytes | 
 Apenas saída. Quantidade de RAM disponível em bytes. | 
| totalMemoryEncryption | 
 Apenas saída. Informações completas sobre a criptografia de memória do dispositivo. | 
TotalMemoryEncryptionInfo
Informações de criptografia de memória de um dispositivo.
- Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
- Os dados desse campo são controlados pela política: ReportDeviceMemoryInfo.
- Frequência de coleta de dados: na inicialização do dispositivo
- Frequência padrão de relatórios de dados: na inicialização do dispositivo
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: Sim
- Informado apenas para usuários afiliados: N/A
| Representação JSON | 
|---|
| { "encryptionState": enum ( | 
| Campos | |
|---|---|
| encryptionState | 
 O estado da criptografia de memória no dispositivo. | 
| maxKeys | 
 O número máximo de chaves que podem ser usadas para criptografia. | 
| keyLength | 
 O comprimento das chaves de criptografia. | 
| encryptionAlgorithm | 
 Algoritmo de criptografia de memória. | 
MemoryEncryptionState
O estado da criptografia de memória no dispositivo.
| Enums | |
|---|---|
| MEMORY_ENCRYPTION_STATE_UNSPECIFIED | O estado da criptografia de memória não foi definido. | 
| MEMORY_ENCRYPTION_STATE_UNKNOWN | O estado da criptografia de memória é desconhecido. | 
| MEMORY_ENCRYPTION_STATE_DISABLED | A criptografia de memória no dispositivo está desativada. | 
| MEMORY_ENCRYPTION_STATE_TME | A criptografia de memória no dispositivo usa a criptografia total de memória. | 
| MEMORY_ENCRYPTION_STATE_MKTME | A criptografia de memória no dispositivo usa a criptografia total de memória com várias chaves. | 
MemoryEncryptionAlgorithm
O algoritmo de criptografia usado no dispositivo.
| Enums | |
|---|---|
| MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED | O algoritmo de criptografia de memória não foi definido. | 
| MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN | O algoritmo de criptografia de memória em uso é desconhecido. | 
| MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 | O algoritmo de criptografia da memória usa o algoritmo de criptografia AES_XTS com uma cifra de bloco de 128 bits. | 
| MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 | O algoritmo de criptografia da memória usa o algoritmo de criptografia AES_XTS com uma cifra de bloco de 256 bits. | 
MemoryStatusReport
Contém amostras de relatórios de status da memória.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceMemoryInfo.
- Frequência de coleta de dados: somente no upload, o SystemRamFreeByes é coletado a cada 10 minutos
- Frequência padrão de relatórios de dados: a cada 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_MEMORY_REPORT
| Representação JSON | 
|---|
| { "reportTime": string, "sampleFrequency": string, "systemRamFreeBytes": string, "pageFaults": integer } | 
| Campos | |
|---|---|
| reportTime | 
 Apenas saída. O carimbo de data/hora em milissegundos que representa o momento em que esse relatório foi amostrado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| sampleFrequency | 
 Apenas saída. Frequência da amostragem do relatório. Duração em segundos com até nove dígitos fracionários, terminando em " | 
| systemRamFreeBytes | 
 Apenas saída. Quantidade de RAM livre em bytes (não confiável devido à coleta de lixo). | 
| pageFaults | 
 Apenas saída. Número de falhas de página durante essa coleta | 
NetworkInfo
Informações do dispositivo de rede.
- Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
- Os dados desse campo são controlados pela política: ReportNetworkDeviceConfiguration
- Frequência de coleta de dados: na inicialização do dispositivo
- Frequência padrão de relatórios de dados: na inicialização do dispositivo
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: Sim
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_NETWORK_INFO
| Representação JSON | 
|---|
| {
  "networkDevices": [
    {
      object ( | 
| Campos | |
|---|---|
| networkDevices[] | 
 Apenas saída. Lista de dispositivos de rede. | 
NetworkDevice
Detalhes sobre o dispositivo de rede.
- Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
- Os dados desse campo são controlados pela política: ReportNetworkDeviceConfiguration
- Frequência de coleta de dados: na inicialização do dispositivo
- Frequência padrão de relatórios de dados: na inicialização do dispositivo
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: Sim
- Informado apenas para usuários afiliados: N/A
| Representação JSON | 
|---|
| {
  "type": enum ( | 
| Campos | |
|---|---|
| type | 
 Apenas saída. Tipo de dispositivo de rede. | 
| macAddress | 
 Apenas saída. Endereço MAC (se aplicável) do dispositivo de rede correspondente. | 
| meid | 
 Apenas saída. MEID (se aplicável) do dispositivo de rede correspondente. | 
| imei | 
 Apenas saída. IMEI (se aplicável) do dispositivo de rede correspondente. | 
| iccid | 
 Apenas saída. O ID do cartão de circuito integrado associado ao chip do dispositivo. | 
| mdn | 
 Apenas saída. O número de diretório de dispositivo móvel associado ao chip do dispositivo. | 
NetworkDeviceType
Tipos de dispositivos de rede.
| Enums | |
|---|---|
| NETWORK_DEVICE_TYPE_UNSPECIFIED | O tipo de dispositivo de rede não foi especificado. | 
| CELLULAR_DEVICE | Dispositivo celular. | 
| ETHERNET_DEVICE | Dispositivo Ethernet. | 
| WIFI_DEVICE | Dispositivo Wi-Fi. | 
NetworkStatusReport
Estado das redes visíveis/configuradas.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportNetworkStatus
- Frequência da coleta de dados: 60 minutos
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: Sim
- Informado apenas para usuários afiliados: sim
- Permissão granular necessária: TELEMETRY_API_NETWORK_REPORT
| Representação JSON | 
|---|
| { "reportTime": string, "sampleFrequency": string, "signalStrengthDbm": integer, "lanIpAddress": string, "gatewayIpAddress": string, "transmissionBitRateMbps": string, "receivingBitRateMbps": string, "transmissionPowerDbm": integer, "encryptionOn": boolean, "wifiLinkQuality": string, "wifiPowerManagementEnabled": boolean, "guid": string, "connectionState": enum ( | 
| Campos | |
|---|---|
| reportTime | 
 Apenas saída. Hora em que o estado da rede foi informado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| sampleFrequency | 
 Apenas saída. Frequência da amostragem do relatório. Duração em segundos com até nove dígitos fracionários, terminando em " | 
| signalStrengthDbm | 
 Apenas saída. Intensidade do sinal de redes sem fio medida em decibéis. | 
| lanIpAddress | 
 Apenas saída. Endereço IP da LAN. | 
| gatewayIpAddress | 
 Apenas saída. Endereço IP do gateway. | 
| transmissionBitRateMbps | 
 Apenas saída. Taxa de bits de transmissão medida em megabits por segundo. | 
| receivingBitRateMbps | 
 Apenas saída. Taxa de bits de recebimento medida em megabits por segundo. | 
| transmissionPowerDbm | 
 Apenas saída. Potência de transmissão medida em decibéis. | 
| encryptionOn | 
 Apenas saída. Indica se a chave de criptografia do Wi-Fi está desativada. | 
| wifiLinkQuality | 
 Apenas saída. Qualidade da conexão de Wi-Fi. O valor varia de [0, 70]. 0 indica ausência de sinal e 70 indica um sinal forte. | 
| wifiPowerManagementEnabled | 
 Apenas saída. Gerenciamento de energia do Wi-Fi ativado | 
| guid | 
 Apenas saída. GUID da conexão de rede. | 
| connectionState | 
 Apenas saída. Estado atual da conexão da rede. | 
| connectionType | 
 Apenas saída. Tipo de conexão de rede. | 
NetworkType
Tipos de conexão de rede.
| Enums | |
|---|---|
| NETWORK_TYPE_UNSPECIFIED | O tipo de conexão de rede não foi especificado | 
| CELLULAR | Conexão de rede celular. | 
| ETHERNET | Conexão de rede Ethernet. | 
| TETHER | Conexão de rede Tether. | 
| VPN | Conexão de rede VPN. | 
| WIFI | Conexão de rede Wi-Fi. | 
NetworkDiagnosticsReport
Resultados de testes de rede para determinar a integridade da conexão de rede do dispositivo, por exemplo, se a latência HTTPS é alta ou normal.
- Permissão granular necessária: TELEMETRY_API_NETWORK_REPORT
| Representação JSON | 
|---|
| {
  "reportTime": string,
  "httpsLatencyData": {
    object ( | 
| Campos | |
|---|---|
| reportTime | 
 Apenas saída. Carimbo de data/hora de quando os diagnósticos foram coletados. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| httpsLatencyData | 
 Apenas saída. Dados de teste de latência do HTTPS. | 
OsUpdateStatus
Contém informações sobre o status atual da atualização do SO.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceOsUpdateStatus.
- Frequência de coleta de dados: somente no upload
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_OS_REPORT
| Representação JSON | 
|---|
| {
  "updateState": enum ( | 
| Campos | |
|---|---|
| updateState | 
 Apenas saída. Estado atual da atualização do SO. | 
| newPlatformVersion | 
 Apenas saída. Nova versão da plataforma da imagem do SO sendo baixada e aplicada. Ele só é definido quando o status de atualização é OS_IMAGE_DOWNLOAD_IN_PROGRESS ou OS_UPDATE_NEED_REBOOT. Pode ser um "0.0.0.0" fictício para o status OS_UPDATE_NEED_REBOOT em alguns casos extremos, por exemplo, quando o mecanismo de atualização é reiniciado sem uma reinicialização. | 
| newRequestedPlatformVersion | 
 Apenas saída. Nova versão da plataforma solicitada do app do quiosque atualizado pendente. | 
| lastUpdateTime | 
 Apenas saída. Carimbo de data/hora da última atualização bem-sucedida. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| lastUpdateCheckTime | 
 Apenas saída. Carimbo de data/hora da última verificação de atualização. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| lastRebootTime | 
 Apenas saída. Carimbo de data/hora da última reinicialização. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
UpdateState
Estado da atualização do SO
| Enums | |
|---|---|
| UPDATE_STATE_UNSPECIFIED | Estado não especificado. | 
| OS_IMAGE_DOWNLOAD_NOT_STARTED | O download do SO não foi iniciado. | 
| OS_IMAGE_DOWNLOAD_IN_PROGRESS | O SO começou a fazer o download no dispositivo. | 
| OS_UPDATE_NEED_REBOOT | O dispositivo precisa ser reiniciado para concluir o upload. | 
GraphicsInfo
Informações do subsistema gráfico.
- Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
- Os dados desse campo são controlados pela política: ReportDeviceGraphicsStatus
- Frequência de coleta de dados: somente no upload
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_GRAPHICS_INFO
| Representação JSON | 
|---|
| { "adapterInfo": { object ( | 
| Campos | |
|---|---|
| adapterInfo | 
 Apenas saída. Informações sobre o adaptador gráfico (GPU). | 
| eprivacySupported | 
 Apenas saída. Indica se a tela de privacidade eletrônica tem suporte ou não. | 
| displayDevices[] | 
 Apenas saída. Informações sobre as telas do dispositivo. | 
| touchScreenInfo | 
 Apenas saída. Informações sobre as telas touch internas do dispositivo. | 
GraphicsAdapterInfo
Informações de um adaptador gráfico (GPU).
| Representação JSON | 
|---|
| { "adapter": string, "driverVersion": string, "deviceId": string } | 
| Campos | |
|---|---|
| adapter | 
 Apenas saída. Nome do adaptador. Exemplo: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2). | 
| driverVersion | 
 Apenas saída. Versão do driver da GPU. | 
| deviceId | 
 Apenas saída. Representa o ID do dispositivo da placa de vídeo. | 
DisplayDevice
Informações de um dispositivo de exibição.
| Representação JSON | 
|---|
| { "displayName": string, "displayWidthMm": integer, "displayHeightMm": integer, "internal": boolean, "manufacturerId": string, "modelId": integer, "manufactureYear": integer } | 
| Campos | |
|---|---|
| displayName | 
 Apenas saída. Nome do dispositivo de exibição. | 
| displayWidthMm | 
 Apenas saída. Largura da tela em milímetros. | 
| displayHeightMm | 
 Apenas saída. Altura da tela em milímetros. | 
| internal | 
 Apenas saída. A tela é interna ou não. | 
| manufacturerId | 
 Apenas saída. ID do fabricante com três letras. | 
| modelId | 
 Apenas saída. Código do produto do fabricante. | 
| manufactureYear | 
 Apenas saída. Ano de fabricação. | 
TouchScreenInfo
Informações na tela de toque do dispositivo.
| Representação JSON | 
|---|
| {
  "touchpadLibrary": string,
  "devices": [
    {
      object ( | 
| Campos | |
|---|---|
| touchpadLibrary | 
 Apenas saída. Nome da biblioteca do touchpad usada pela pilha de entrada. | 
| devices[] | 
 Apenas saída. Lista dos dispositivos de tela touchscreen internos. | 
TouchScreenDevice
Informações de um dispositivo de tela touch interno.
| Representação JSON | 
|---|
| { "displayName": string, "touchPointCount": integer, "stylusCapable": boolean } | 
| Campos | |
|---|---|
| displayName | 
 Apenas saída. Nome de exibição do dispositivo com tela touch. | 
| touchPointCount | 
 Apenas saída. Número de pontos de toque compatíveis com o dispositivo. | 
| stylusCapable | 
 Apenas saída. O dispositivo com tela touch é compatível com stylus ou não. | 
GraphicsStatusReport
Informações do subsistema gráfico.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceGraphicsInfo.
- Frequência da coleta de dados: 3 horas.
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_GRAPHICS_REPORT
| Representação JSON | 
|---|
| {
  "reportTime": string,
  "displays": [
    {
      object ( | 
| Campos | |
|---|---|
| reportTime | 
 Apenas saída. Hora em que os dados gráficos foram informados. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| displays[] | 
 Apenas saída. Informações sobre as telas do dispositivo. | 
DisplayInfo
Informações para uma tela.
| Representação JSON | 
|---|
| { "deviceId": string, "resolutionWidth": integer, "resolutionHeight": integer, "refreshRate": integer, "isInternal": boolean, "displayName": string } | 
| Campos | |
|---|---|
| deviceId | 
 Apenas saída. Representa o ID do dispositivo da placa de vídeo. | 
| resolutionWidth | 
 Apenas saída. Largura da resolução em pixels. | 
| resolutionHeight | 
 Apenas saída. Altura da resolução em pixels. | 
| refreshRate | 
 Apenas saída. Taxa de atualização em Hz. | 
| isInternal | 
 Apenas saída. Indica se a tela é interna ou não. | 
| displayName | 
 Apenas saída. Nome do dispositivo de exibição. | 
BatteryInfo
Informações sobre a bateria.
- Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
- Os dados desse campo são controlados pela política: ReportDevicePowerStatus
- Frequência de coleta de dados: somente no upload
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_BATTERY_INFO
| Representação JSON | 
|---|
| {
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object ( | 
| Campos | |
|---|---|
| serialNumber | 
 Apenas saída. Número de série da bateria. | 
| manufacturer | 
 Apenas saída. Fabricante da bateria. | 
| designCapacity | 
 Apenas saída. Capacidade de design (mA-h). | 
| designMinVoltage | 
 Apenas saída. Tensão mínima de saída (mV) projetada | 
| manufactureDate | 
 Apenas saída. A data de fabricação da bateria. | 
| technology | 
 Apenas saída. Tecnologia da bateria. Exemplo: Li-ion | 
BatteryStatusReport
Dados de status da bateria.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDevicePowerStatus
- Frequência de coleta de dados: somente no upload
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_BATTERY_REPORT
| Representação JSON | 
|---|
| { "reportTime": string, "serialNumber": string, "sample": [ { object ( | 
| Campos | |
|---|---|
| reportTime | 
 Apenas saída. Carimbo de data/hora de quando a amostra foi coletada no dispositivo Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| serialNumber | 
 Apenas saída. Número de série da bateria. | 
| sample[] | 
 Apenas saída. Dados de amostra da bateria classificados em ordem decrescente de  | 
| batteryHealth | 
 Apenas saída. Integridade da bateria. | 
| fullChargeCapacity | 
 Apenas saída. Capacidade de carga total (mA-h). | 
| cycleCount | 
 Apenas saída. Contagem de ciclos. | 
BatterySampleReport
Amostragem de dados de bateria.
- Esse campo contém informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDevicePowerStatus
- Frequência de coleta de dados: somente no upload
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
| Representação JSON | 
|---|
| { "reportTime": string, "voltage": string, "remainingCapacity": string, "temperature": integer, "dischargeRate": integer, "chargeRate": integer, "current": string, "status": string } | 
| Campos | |
|---|---|
| reportTime | 
 Apenas saída. Carimbo de data/hora de quando a amostra foi coletada no dispositivo Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| voltage | 
 Apenas saída. Tensão da bateria (milivolt). | 
| remainingCapacity | 
 Apenas saída. Capacidade restante da bateria (mA-h). | 
| temperature | 
 Apenas saída. Temperatura em graus Celsius. | 
| dischargeRate | 
 Apenas saída. Taxa de descarga da bateria medida em mW. Positivo se a bateria estiver sendo descarregada, negativo se estiver sendo carregada. | 
| chargeRate | 
 Apenas saída. Porcentagem de carga da bateria. | 
| current | 
 Apenas saída. Corrente da bateria (mA). | 
| status | 
 Apenas saída. O status da bateria é lido do sysfs. Exemplo: descarregar | 
BatteryHealth
Representa a integridade atual da bateria.
- Esse status não é um indicador ou a indicação de uma bateria com defeito. Ela é calculada dividindo a capacidade de carga total atual pela capacidade de projeto.
- Cabe ao fabricante definir a integridade da bateria e a política de garantia.
| Enums | |
|---|---|
| BATTERY_HEALTH_UNSPECIFIED | Integridade desconhecida. | 
| BATTERY_HEALTH_NORMAL | A bateria está em bom estado, a capacidade de carga total / capacidade de projeto é maior que 80% | 
| BATTERY_REPLACE_SOON | A bateria está moderadamente inadequada e deve ser substituída em breve. A capacidade de carga total / capacidade de projeto é de 75% a 80%. | 
| BATTERY_REPLACE_NOW | A bateria está com problemas e precisa ser substituída. A capacidade de carga total / capacidade de projeto é < 75% | 
StorageInfo
Dados de status para armazenamento.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceStorageStatus.
- Frequência de coleta de dados: somente no upload
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_STORAGE_INFO
| Representação JSON | 
|---|
| {
  "volume": [
    {
      object ( | 
| Campos | |
|---|---|
| volume[] | 
 Informações sobre volumes de disco | 
| availableDiskBytes | 
 O espaço disponível para armazenamento de dados do usuário no dispositivo em bytes. | 
| totalDiskBytes | 
 O espaço total para armazenamento de dados do usuário no dispositivo em bytes. | 
DiskVolume
Informações sobre volumes de disco
| Representação JSON | 
|---|
| { "volumeId": string, "storageFreeBytes": string, "storageTotalBytes": string } | 
| Campos | |
|---|---|
| volumeId | 
 ID do volume do disco. | 
| storageFreeBytes | 
 Espaço de armazenamento livre em bytes. | 
| storageTotalBytes | 
 Espaço de armazenamento total em bytes. | 
StorageStatusReport
Dados de status para armazenamento.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceStorageStatus.
- Frequência de coleta de dados: somente no upload
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_STORAGE_REPORT
| Representação JSON | 
|---|
| {
  "reportTime": string,
  "disk": [
    {
      object ( | 
| Campos | |
|---|---|
| reportTime | 
 Apenas saída. Carimbo de data/hora de quando a amostra foi coletada no dispositivo Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| disk[] | 
 Apenas saída. Relatórios no disco. | 
DiskInfo
Status do único dispositivo de armazenamento.
| Representação JSON | 
|---|
| { "serialNumber": string, "manufacturer": string, "model": string, "sizeBytes": string, "type": string, "health": string, "volumeIds": [ string ], "bytesReadThisSession": string, "bytesWrittenThisSession": string, "readTimeThisSession": string, "writeTimeThisSession": string, "ioTimeThisSession": string, "discardTimeThisSession": string } | 
| Campos | |
|---|---|
| serialNumber | 
 Apenas saída. Número de série do disco. | 
| manufacturer | 
 Apenas saída. Fabricante do disco. | 
| model | 
 Apenas saída. Modelo do disco. | 
| sizeBytes | 
 Apenas saída. Tamanho do disco | 
| type | 
 Apenas saída. Tipo de disco: eMMC / NVMe / ATA / SCSI. | 
| health | 
 Apenas saída. Integridade do disco. | 
| volumeIds[] | 
 Apenas saída. Volumes de disco. | 
| bytesReadThisSession | 
 Apenas saída. Número de bytes lidos desde a última inicialização. | 
| bytesWrittenThisSession | 
 Apenas saída. Número de bytes gravados desde a última inicialização. | 
| readTimeThisSession | 
 Apenas saída. Tempo gasto lendo do disco desde a última inicialização. Duração em segundos com até nove dígitos fracionários, terminando em " | 
| writeTimeThisSession | 
 Apenas saída. Tempo gasto em gravações no disco desde a última inicialização. Duração em segundos com até nove dígitos fracionários, terminando em " | 
| ioTimeThisSession | 
 Apenas saída. Conta o tempo em que o disco e a fila estavam ocupados. Portanto, ao contrário dos campos acima, as solicitações paralelas não são contadas várias vezes. Duração em segundos com até nove dígitos fracionários, terminando em " | 
| discardTimeThisSession | 
 Apenas saída. Tempo gasto com descarte desde a última inicialização. O descarte é a gravação em blocos claros que não estão mais em uso. Com suporte em kernels 4.18 e mais recentes. Duração em segundos com até nove dígitos fracionários, terminando em " | 
ThunderboltInfo
Informações do barramento Thunderbolt.
- Esse campo fornece informações do dispositivo, que são estáticas e não mudam com o tempo.
- Os dados desse campo são controlados pela política: ReportDeviceSecurityStatus.
- Frequência de coleta de dados: na inicialização do dispositivo
- Frequência padrão de relatórios de dados: na inicialização do dispositivo
            - Controle de políticas: não
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: Sim
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_BUS_DEVICE_INFO
| Representação JSON | 
|---|
| {
  "securityLevel": enum ( | 
| Campos | |
|---|---|
| securityLevel | 
 Nível de segurança do barramento Thunderbolt. | 
ThunderboltSecurityLevel
Nível de segurança do barramento Thunderbolt.
| Enums | |
|---|---|
| THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED | O nível de segurança do Thunderbolt não está definido. | 
| THUNDERBOLT_SECURITY_NONE_LEVEL | Todos os dispositivos são conectados automaticamente pelo firmware. Não é necessária a aprovação do usuário. | 
| THUNDERBOLT_SECURITY_USER_LEVEL | O usuário é questionado se o dispositivo pode ser conectado. | 
| THUNDERBOLT_SECURITY_SECURE_LEVEL | O usuário é questionado se o dispositivo pode ser conectado. Além disso, o dispositivo recebe um desafio que precisa corresponder ao esperado com base em uma chave aleatória gravada no atributo sysfs da chave. | 
| THUNDERBOLT_SECURITY_DP_ONLY_LEVEL | O firmware cria túneis automaticamente para o Thunderbolt. | 
| THUNDERBOLT_SECURITY_USB_ONLY_LEVEL | O firmware cria túneis automaticamente para o controlador USB e a porta de exibição em uma base. Todos os links PCIe downstream da base são removidos. | 
| THUNDERBOLT_SECURITY_NO_PCIE_LEVEL | O encapsulamento de PCIE está desativado. | 
BootPerformanceReport
Relatório de desempenho de inicialização de um dispositivo.
- Esse campo é de informações de telemetria e muda com o tempo conforme o dispositivo é utilizado.
- Os dados desse campo são controlados pela política: ReportDeviceBootMode
- Frequência de coleta de dados: em todos os eventos de inicialização
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: Sim
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_OS_REPORT
| Representação JSON | 
|---|
| {
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum ( | 
| Campos | |
|---|---|
| bootUpDuration | 
 Tempo total de inicialização. Duração em segundos com até nove dígitos fracionários, terminando em " | 
| bootUpTime | 
 O carimbo de data/hora da última vez que a energia foi ligada. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| shutdownDuration | 
 Tempo total desde o início da interrupção até a desativação. Duração em segundos com até nove dígitos fracionários, terminando em " | 
| shutdownTime | 
 O carimbo de data/hora do desligamento. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| shutdownReason | 
 O motivo do desligamento. | 
| reportTime | 
 Carimbo de data/hora em que o relatório foi coletado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
ShutdownReason
O motivo do desligamento.
| Enums | |
|---|---|
| SHUTDOWN_REASON_UNSPECIFIED | O motivo do desligamento não foi especificado. | 
| USER_REQUEST | Iniciado pelo usuário. | 
| SYSTEM_UPDATE | Atualização do sistema iniciada. | 
| LOW_BATTERY | Desligamento devido à bateria fraca. | 
| OTHER | Desligamento por outros motivos. | 
HeartbeatStatusReport
Relatório de status de sinal de funcionamento de um dispositivo.
- Disponível para quiosques
- Esse campo fornece o status on-line/off-line/desconhecido de um dispositivo e só será incluído se o status tiver mudado (por exemplo, "On-line" para "Off-line").
- Os dados desse campo são controlados pela política: HeartbeatEnabled Mais informações
- Frequência de batimentos: 2 minutos
            - Observação: quando um dispositivo fica off-line, pode levar até 12 minutos para que o status on-line dele seja atualizado.
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line: N/A
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
| Representação JSON | 
|---|
| {
  "reportTime": string,
  "state": enum ( | 
| Campos | |
|---|---|
| reportTime | 
 Carimbo de data/hora em que a mudança de status foi detectada Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| state | 
 Estado para o qual o dispositivo mudou | 
Estado
O estado do dispositivo
| Enums | |
|---|---|
| STATE_UNSPECIFIED | Estado não especificado | 
| UNKNOWN | O dispositivo não está qualificado para monitoramento de batimentos | 
| ONLINE | O dispositivo está on-line | 
| OFFLINE | O dispositivo está off-line | 
| DEVICE_OUTDATED | O dispositivo está desatualizado | 
KioskAppStatusReport
Relatório de status do app de quiosque de um dispositivo.
- Disponível para quiosques
- Esse campo fornece o ID e o número da versão do app em execução em um dispositivo de quiosque e o carimbo de data/hora da última atualização do relatório.
- Os dados desse campo são controlados pela política: ReportDeviceSessionStatus
- Frequência de coleta de dados: somente no upload
- Frequência padrão de relatórios de dados: 3 horas
            - Controle de políticas: sim
 
- Cache: se o dispositivo estiver off-line, os dados coletados serão armazenados localmente e informados quando o dispositivo estiver on-line novamente: Não
- Informado apenas para usuários afiliados: N/A
- Permissão granular necessária: TELEMETRY_API_APPS_REPORT
| Representação JSON | 
|---|
| { "reportTime": string, "appId": string, "appVersion": string } | 
| Campos | |
|---|---|
| reportTime | 
 Carimbo de data/hora de quando o relatório foi coletado Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| appId | 
 ID do app de quiosque, por exemplo, "mdmkkicfmmkgmpkmkdikhlbggogpicma" | 
| appVersion | 
 Número da versão do app de quiosque, por exemplo, "1.10.118" | 
RuntimeCountersReport
Contadores de execução recuperados da CPU. No momento, a telemetria dos contadores de tempo de execução tem suporte apenas para o Intel vPro PSR na 14ª geração e mais recentes.
| Representação JSON | 
|---|
| { "reportTime": string, "uptimeRuntimeDuration": string, "enterSleepCount": string, "enterHibernationCount": string, "enterPoweroffCount": string } | 
| Campos | |
|---|---|
| reportTime | 
 Carimbo de data/hora em que o relatório foi coletado. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos:  | 
| uptimeRuntimeDuration | 
 Tempo de execução total. Atualmente, sempre o tempo de execução S0 do Intel vPro PSR. Duração em segundos com até nove dígitos fracionários, terminando em " | 
| enterSleepCount | 
 Número de vezes que o dispositivo entrou no estado de inatividade. Atualmente, é obtido pelo PSR, contagem de S0 a S3. | 
| enterHibernationCount | 
 Número de vezes que o dispositivo entrou no estado de hibernação. Atualmente, é obtido pelo PSR, contagem de S0 a S4. | 
| enterPoweroffCount | 
 Número de vezes que o dispositivo entrou no estado de desligamento. Atualmente, é obtida pelo PSR, contando de S0 a S5. | 
| Métodos | |
|---|---|
| 
 | Receber o dispositivo de telemetria. | 
| 
 | Lista todos os dispositivos de telemetria. | 
