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 evento de underrun grave de áudio. Presente apenas quando o campo eventType é AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

Apenas saída. Payload para o evento de alteração do estado da conexão de rede. Presente apenas quando eventType for NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Apenas saída. Payload para o evento de alteração da latência HTTPS. Presente apenas quando eventType for NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

Apenas saída. Payload para o evento de alteração do estado da conexão VPN. Presente apenas quando eventType for VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Apenas saída. Payload para o evento de instalação do app. Presente apenas quando eventType for APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Apenas saída. Payload para o evento de desinstalação do app. Presente apenas quando eventType for 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 que o ID da API Directory do Admin Console na guia "Dispositivos" do 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 os 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 que foram 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 HTTPs é executada periodicamente, e TelemetryHttpsLatencyChangeEvent é acionado se um problema de latência for detectado ou se o dispositivo tiver se recuperado 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 da rotina de latência HTTPS que acionaram o evento.
httpsLatencyState

enum (HttpsLatencyState)

Estado de latência atual do HTTPS.

HttpsLatencyState

Estado de latência do HTTPS.

Tipos enumerados
HTTPS_LATENCY_STATE_UNSPECIFIED O estado de latência HTTPS não foi especificado.
RECOVERY Latência HTTPS 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 de 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)

Origem da 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 aplicativo Para PWAs, esse é o URL de início e, para extensões, esse é o ID da extensão.
appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationInstallSource

Descreve a origem de instalação do app.

Tipos enumerados
APPLICATION_INSTALL_SOURCE_UNSPECIFIED A origem da instalação do aplicativo é 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 origem da 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 da instalação do aplicativo é um navegador.

ApplicationInstallReason

Descreve o motivo da instalação do app.

Tipos enumerados
APPLICATION_INSTALL_REASON_UNSPECIFIED O motivo da instalação do aplicativo é desconhecido.
APPLICATION_INSTALL_REASON_SYSTEM Aplicativo instalado com o sistema e é considerado parte do SO.
APPLICATION_INSTALL_REASON_POLICY Aplicativo instalado pela 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 Aplicativo instalado pela sincronização.
APPLICATION_INSTALL_REASON_USER Aplicativo instalado por ação do usuário.
APPLICATION_INSTALL_REASON_SUB_APP Aplicativo instalado com chamada de API do SubApp.
APPLICATION_INSTALL_REASON_KIOSK Aplicativo instalado pelo quiosque no Chrome OS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Aplicativo instalado pelo argumento da linha de comando.

ApplicationInstallTime

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

Tipos enumerados
APPLICATION_INSTALL_TIME_UNSPECIFIED Tempo de instalação do aplicativo 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 da desinstalação do app.
appId

string

ID do aplicativo Para PWAs, esse é o URL de início e, para extensões, esse é o ID da extensão.
appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationUninstallSource

Descreve a origem da desinstalação do app.

Tipos enumerados
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Origem da desinstalação do aplicativo desconhecida.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Aplicativo desinstalado da lista de aplicativos (acesso rápido).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Aplicativo desinstalado da página "Gerenciamento de apps".
APPLICATION_UNINSTALL_SOURCE_SHELF Aplicativo desinstalado da estante.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Aplicativo desinstalado pela migração de app.

TelemetryAppLaunchEvent

Dados de inicialização do app.

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

enum (ApplicationLaunchSource)

Fonte da inicialização do app.
appId

string

ID do aplicativo Para PWAs, esse é o URL de início e, para extensões, esse é o ID da extensão.
appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationLaunchSource

Descreve a origem da inicialização do app.

Tipos enumerados
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Origem da inicialização do aplicativo desconhecida.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Aplicativo iniciado a partir da grade de aplicativos, não da caixa de pesquisa.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Aplicativo iniciado a partir da 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 Aplicativo iniciado a partir de recomendações sem consulta (ícones menores).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Aplicativo iniciado na seção "Configurações do controle da família" e na notificação "Horário por app".
APPLICATION_LAUNCH_SOURCE_SHELF Aplicativo iniciado na estante.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Aplicativo iniciado no gerenciador de arquivos
APPLICATION_LAUNCH_SOURCE_OMNIBOX Aplicativo iniciado ao digitar um URL na omnibox no navegador.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Aplicativo iniciado de uma chamada interna do Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Aplicativo iniciado a partir do atalho de teclado para abrir o aplicativo.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Aplicativo iniciado clicando em um link em outro app ou WebUI.
APPLICATION_LAUNCH_SOURCE_MENU Aplicativo iniciado no menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Aplicativo iniciado pela notificação instalada.
APPLICATION_LAUNCH_SOURCE_TEST Aplicativo iniciado de um teste.
APPLICATION_LAUNCH_SOURCE_ARC Aplicativo iniciado pelo Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Aplicativo iniciado no Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Aplicativo iniciado na notificação de notas da versão.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Aplicativo iniciado de uma restauração completa.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Aplicativo iniciado de um menu de contexto de seleção inteligente de texto.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Aplicativo iniciado em uma notificação de descoberta da guia.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplicativo iniciado na API Management.
APPLICATION_LAUNCH_SOURCE_KIOSK Aplicativo iniciado do quiosque.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Aplicativo iniciado na linha de comando.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Aplicativo iniciado do modo de segundo plano.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Aplicativo iniciado na página "Nova guia".
APPLICATION_LAUNCH_SOURCE_INTENT_URL Aplicativo iniciado de um URL de intent.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Aplicativo iniciado a partir do Login do SO.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Aplicativo iniciado do gerenciador de protocolo.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Aplicativo iniciado do gerenciador de URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Aplicativo iniciado pelo Acesso rápido aos apps da tela de bloqueio.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Aplicativo iniciado na página inicial (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Aplicativo iniciado ao mover conteúdo para um aplicativo.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Aplicativo iniciado no menu de perfil da interface da Web instalável chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Aplicativo iniciado a partir da agenda da bandeja do sistema.
APPLICATION_LAUNCH_SOURCE_INSTALLER Aplicativo iniciado a partir do instalador de origem.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Contabilize as inicializações do app de ajuda de primeira execução separadamente para que possamos entender o número de inicializações acionadas pelo usuário.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Aplicativo iniciado a partir do tour de boas-vindas.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Aplicação iniciada no painel de foco.

Métodos

list

 Lista eventos de telemetria.