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

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
eventType

enum (EventType)

O tipo do evento atual.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Apenas saída. Payload para o 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 apenas quando eventType for NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Apenas saída. Payload do evento de alteração da latência 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 do app. Presente somente quando eventType é APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Apenas saída. Payload do 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 for APP_LAUNCHED.

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 quando o estado da conexão de rede muda.

  • 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 de latência do HTTPS atual.

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

Fonte 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 de instalação do aplicativo é uma sincronização.
APPLICATION_INSTALL_SOURCE_PLAY_STORE A fonte de instalação do aplicativo é a Play Store.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE A origem da 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 aplicativo do sistema.
APPLICATION_INSTALL_REASON_SYNC O app foi instalado por sincronização.
APPLICATION_INSTALL_REASON_USER Aplicativo instalado por ação do 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 de 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, esse é o URL inicial. 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 aplicativo 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 O aplicativo é iniciado na grade de apps, fora do menu de contexto.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Aplicativo iniciado a partir de resultados dependentes de 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 de 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 Aplicativo iniciado ao inserir um URL na omnibox no navegador.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Aplicativo iniciado em uma chamada interna do Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD O app é iniciado pelo atalho de 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 é iniciado pela notificação instalada.
APPLICATION_LAUNCH_SOURCE_TEST Aplicativo iniciado a partir de 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 Aplicativo iniciado em um menu de contexto de seleção inteligente de texto.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION O app foi iniciado em uma notificação da guia "Discover".
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplicativo iniciado a partir da API de gerenciamento.
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 iniciado 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 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 chrome://password-manager WebUI instalável.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR O aplicativo foi 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 inicial.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE O aplicativo foi iniciado no painel de foco.
APPLICATION_LAUNCH_SOURCE_SPARKY Aplicativo lançado com base no recurso experimental Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING O aplicativo foi iniciado pela captura de navegação.

Métodos

list

 Lista eventos de telemetria.