REST Resource: customers.telemetry.events

Recurso: TelemetryEvent

Dados de telemetria informados por um dispositivo gerenciado.

Representação JSON 
{
  "name": string,
  "device": {
    object (TelemetryDeviceInfo)
  },
  "user": {
    object (TelemetryUserInfo)
  },
  "reportTime": string,
  "eventType": enum (EventType),
  "audioSevereUnderrunEvent": {
    object (TelemetryAudioSevereUnderrunEvent)
  },
  "usbPeripheralsEvent": {
    object (TelemetryUsbPeripheralsEvent)
  },
  "networkStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  },
  "httpsLatencyChangeEvent": {
    object (TelemetryHttpsLatencyChangeEvent)
  },
  "wifiSignalStrengthEvent": {
    object (TelemetryNetworkSignalStrengthEvent)
  },
  "vpnConnectionStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  },
  "appInstallEvent": {
    object (TelemetryAppInstallEvent)
  },
  "appUninstallEvent": {
    object (TelemetryAppUninstallEvent)
  },
  "appLaunchEvent": {
    object (TelemetryAppLaunchEvent)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  }
}
Campos
name

string

Apenas saída. Nome do recurso do evento.
device

object (TelemetryDeviceInfo)

Apenas saída. Informações sobre o dispositivo associado ao evento.
user

object (TelemetryUserInfo)

Apenas saída. Informações sobre o usuário associado ao evento.
reportTime

string (Timestamp format)

Carimbo de data/hora que representa quando o evento 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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
eventType

enum (EventType)

O tipo de evento atual.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Apenas saída. Payload para evento de underrun grave de áudio. Presente somente quando o campo eventType é AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Apenas saída. Payload para o evento de periféricos USB. Presente somente quando o campo eventType é USB_ADDED ou USB_REMOVED.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Apenas saída. Payload para o evento de mudança de estado da conexão de rede. Presente somente quando eventType é NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Apenas saída. Payload para o evento de mudança de latência do HTTPS. Presente somente quando eventType é NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Apenas saída. Payload para eventos de intensidade do sinal Wi-Fi. Aparece apenas quando eventType é WIFI_SIGNAL_STRENGTH_LOW ou WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Apenas saída. Payload para o evento de mudança de estado da conexão VPN. Presente somente quando eventType é VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Apenas saída. Payload do evento de instalação de app. Presente somente quando eventType é APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Apenas saída. Payload para o evento de desinstalação do app. Presente somente quando eventType é APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Apenas saída. Payload para o evento de inicialização do app.Presente apenas quando eventType é APP_LAUNCHED.
osCrashEvent

object (TelemetryOsCrashEvent)

Apenas saída. Payload para o evento de falha do SO. Presente somente quando eventType é OS_CRASH.

TelemetryDeviceInfo

Informações sobre um dispositivo associado a dados de telemetria.

  • Permissão granular necessária: TELEMETRY_API_DEVICE
Representação JSON 
{
  "deviceId": string,
  "orgUnitId": string
}
Campos
deviceId

string

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

string

Apenas saída. ID da unidade organizacional do dispositivo.

TelemetryUserInfo

Informações sobre um usuário associado a dados de telemetria.

  • Permissão granular necessária: TELEMETRY_API_USER
Representação JSON 
{
  "email": string,
  "orgUnitId": string
}
Campos
email

string

Apenas saída. E-mail do usuário.
orgUnitId

string

Apenas saída. ID da unidade organizacional do usuário.

TelemetryAudioSevereUnderrunEvent

Esse tipo não tem campos.

O TelemetryAudioSevereUnderrunEvent é acionado quando um dispositivo de áudio fica sem dados de buffer por mais de cinco segundos.

  • Permissão granular necessária: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent é acionado quando dispositivos USB são adicionados ou removidos.

  • Permissão granular necessária: TELEMETRY_API_PERIPHERALS_REPORT
Representação JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Campos
usbPeripheralReport[]

object (UsbPeripheralReport)

Lista de dispositivos USB adicionados ou removidos.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent é acionado em mudanças de estado da conexão de rede.

  • Permissão granular necessária: TELEMETRY_API_NETWORK_REPORT
Representação JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Campos
guid

string

Identificador exclusivo da rede.
connectionState

enum (NetworkConnectionState)

Estado atual da conexão da rede.

TelemetryHttpsLatencyChangeEvent

A rotina de latência do HTTPs é executada periodicamente, e TelemetryHttpsLatencyChangeEvent é acionado se um problema de latência for detectado ou se o dispositivo se recuperar de um problema de latência.

  • Permissão granular necessária: TELEMETRY_API_NETWORK_REPORT
Representação JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Campos
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Dados de rotina de latência HTTPS que acionaram o evento.
httpsLatencyState

enum (HttpsLatencyState)

Estado atual da latência do HTTPS.

HttpsLatencyState

Estado de latência do HTTPS.

Enums
HTTPS_LATENCY_STATE_UNSPECIFIED O estado de latência do HTTPS não foi especificado.
RECOVERY A latência HTTPS foi recuperada de um problema.
PROBLEM Problema de latência do HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent é acionado em eventos de intensidade do sinal Wi-Fi.

  • Permissão granular necessária: TELEMETRY_API_NETWORK_REPORT
Representação JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
Campos
guid

string

Identificador exclusivo da rede.
signalStrengthDbm

integer

Valor RSSI da intensidade do sinal.

TelemetryAppInstallEvent

Dados de instalação do app.

Representação JSON 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Campos
appInstallSource

enum (ApplicationInstallSource)

Origem de instalação do app.
appInstallReason

enum (ApplicationInstallReason)

Motivo da instalação do app.
appInstallTime

enum (ApplicationInstallTime)

Tempo de instalação do app, dependendo do ciclo de vida.
appId

string

ID do app. Para PWAs, é o URL inicial, e para extensões, é o ID da extensão.
appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationInstallSource

Descreve a origem da instalação do app.

Enums
APPLICATION_INSTALL_SOURCE_UNSPECIFIED A origem da instalação do app é desconhecida.
APPLICATION_INSTALL_SOURCE_SYSTEM Aplicativo instalado como parte do Chrome OS.
APPLICATION_INSTALL_SOURCE_SYNC A origem da instalação do aplicativo é uma sincronização.
APPLICATION_INSTALL_SOURCE_PLAY_STORE A fonte de instalação do app é a Play Store.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE A origem de instalação do aplicativo é a Chrome Web Store.
APPLICATION_INSTALL_SOURCE_BROWSER A origem de instalação do aplicativo é um navegador.

ApplicationInstallReason

Descreve o motivo da instalação do app.

Enums
APPLICATION_INSTALL_REASON_UNSPECIFIED O motivo da instalação do app é desconhecido.
APPLICATION_INSTALL_REASON_SYSTEM Aplicativo instalado com o sistema e considerado parte do SO.
APPLICATION_INSTALL_REASON_POLICY Aplicativo instalado por política.
APPLICATION_INSTALL_REASON_OEM Aplicativo instalado por um fabricante de equipamento original (OEM).
APPLICATION_INSTALL_REASON_DEFAULT Aplicativo instalado por padrão, mas não é considerado um app do sistema.
APPLICATION_INSTALL_REASON_SYNC O app foi instalado por sincronização.
APPLICATION_INSTALL_REASON_USER Aplicativo instalado pelo usuário.
APPLICATION_INSTALL_REASON_SUB_APP O aplicativo foi instalado pela chamada de API do SubApp.
APPLICATION_INSTALL_REASON_KIOSK App instalado pelo modo quiosque no Chrome OS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Aplicativo instalado pelo argumento de linha de comando.

ApplicationInstallTime

Descreve o tempo de instalação do app dependendo do ciclo de vida dele.

Enums
APPLICATION_INSTALL_TIME_UNSPECIFIED Tempo de instalação do app desconhecido.
APPLICATION_INSTALL_TIME_INIT A instalação do aplicativo é inicializada.
APPLICATION_INSTALL_TIME_RUNNING A instalação do aplicativo está em execução.

TelemetryAppUninstallEvent

Dados de desinstalação do app.

Representação JSON 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Campos
appUninstallSource

enum (ApplicationUninstallSource)

Origem de desinstalação do app.
appId

string

ID do app. Para PWAs, é o URL inicial, e para extensões, é o ID da extensão.
appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationUninstallSource

Descreve a origem da desinstalação do app.

Enums
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED A origem do desinstalação do app é desconhecida.
APPLICATION_UNINSTALL_SOURCE_APP_LIST O aplicativo foi desinstalado da lista de apps (Acesso rápido aos apps).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Aplicativo desinstalado da página "Gerenciamento de apps".
APPLICATION_UNINSTALL_SOURCE_SHELF O aplicativo foi desinstalado da seção "Recomendados".
APPLICATION_UNINSTALL_SOURCE_MIGRATION O aplicativo foi desinstalado pela migração.

TelemetryAppLaunchEvent

Dados de inicialização do app.

Representação JSON 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Campos
appLaunchSource

enum (ApplicationLaunchSource)

Origem de inicialização do app.
appId

string

ID do app. Para PWAs, é o URL inicial, e para extensões, é o ID da extensão.
appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationLaunchSource

Descreve a origem de inicialização do app.

Enums
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Origem de inicialização do app desconhecida.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID O aplicativo foi iniciado na grade de apps, não na caixa de pesquisa.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Aplicativo iniciado na grade de apps, fora do menu de contexto.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Aplicativo iniciado a partir de resultados dependentes da consulta (ícones maiores).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Aplicativo iniciado a partir de resultados dependentes de consulta, fora do menu de contexto.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION O aplicativo é iniciado a partir de recomendações sem consulta (ícones menores).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS O aplicativo é iniciado na seção "Configurações de controle da família" e na notificação "Tempo por app".
APPLICATION_LAUNCH_SOURCE_SHELF O aplicativo foi iniciado na seção "Estante".
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Aplicativo iniciado pelo gerenciador de arquivos
APPLICATION_LAUNCH_SOURCE_OMNIBOX O aplicativo é iniciado ao inserir um URL na Omnibox do navegador.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Aplicativo iniciado por uma chamada interna do Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD O aplicativo é iniciado pelo atalho do teclado para abrir o app.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Aplicativo iniciado ao clicar em um link em outro app ou na WebUI.
APPLICATION_LAUNCH_SOURCE_MENU O aplicativo é iniciado no menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION O app foi iniciado pela notificação instalada.
APPLICATION_LAUNCH_SOURCE_TEST O aplicativo foi iniciado por um teste.
APPLICATION_LAUNCH_SOURCE_ARC O aplicativo foi iniciado no Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Aplicativo iniciado na Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION O app é iniciado pela notificação dos avisos de lançamento.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE O aplicativo foi iniciado após uma restauração completa.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU O aplicativo é iniciado em um menu de contexto de seleção de texto inteligente.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION O app foi aberto em uma notificação da guia "Descobrir".
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplicativo iniciado pela API Management.
APPLICATION_LAUNCH_SOURCE_KIOSK O aplicativo foi iniciado no quiosque.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Aplicativo iniciado na linha de comando.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE O aplicativo foi iniciado no modo em segundo plano.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Aplicativo aberto na página "Nova guia".
APPLICATION_LAUNCH_SOURCE_INTENT_URL Aplicativo iniciado por um URL de intent.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN O aplicativo foi iniciado no login do SO.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER O aplicativo é iniciado pelo gerenciador de protocolos.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Aplicativo iniciado pelo manipulador de URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Aplicativo iniciado no acesso rápido aos apps da tela de bloqueio.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE O aplicativo é iniciado na página inicial do app (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING O aplicativo é iniciado ao mover conteúdo para um app.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU O aplicativo é iniciado no menu de perfil da WebUI instalável chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Aplicativo iniciado na agenda da bandeja do sistema.
APPLICATION_LAUNCH_SOURCE_INSTALLER Aplicativo iniciado pelo instalador de origem.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Conte as inicializações do app de ajuda da primeira vez separadamente para entender o número de inicializações acionadas pelo usuário.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR O aplicativo é iniciado na apresentação de boas-vindas.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE O aplicativo foi iniciado no painel de foco.
APPLICATION_LAUNCH_SOURCE_SPARKY O aplicativo foi iniciado pelo recurso experimental Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING O aplicativo foi iniciado pela captura de navegação.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Aplicativo iniciado pela API de instalação na Web.

TelemetryOsCrashEvent

Dados de falhas do SO.

Representação JSON 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
Campos
crashType

enum (CrashType)

Tipo de falha.
sessionType

enum (SessionType)

Tipo de sessão.
crashId

string

ID da falha.

CrashType

Descreve o tipo de falha.

Enums
CRASH_TYPE_UNSPECIFIED Tipo de falha desconhecido.
CRASH_TYPE_KERNEL Falha do kernel.
CRASH_TYPE_EMBEDDED_CONTROLLER Falhas do controlador incorporado.

SessionType

Descreve o tipo de sessão.

Enums
SESSION_TYPE_UNSPECIFIED Tipo de sessão desconhecido.
SESSION_TYPE_SIGNED_IN_USER Usuário conectado.
SESSION_TYPE_KIOSK Quiosque:
SESSION_TYPE_MANAGED_GUEST Sessão de visitante gerenciada.
SESSION_TYPE_ACTIVE_DIRECTORY Sessão do Active Directory.

Métodos

list

 Lista eventos de telemetria.