REST Resource: customers.telemetry.events

Recurso: TelemetryEvent

Dados de telemetria relatados 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 relatado.

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 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 do 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 do 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 do sinal de Wi-Fi. Presente apenas quando eventType é WIFI_SIGNAL_STRENGTH_LOW ou WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Apenas saída. Payload do 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 do evento de instalação do app. Presente apenas quando eventType for APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Apenas saída. Payload do evento de desinstalação do app. Presente apenas quando eventType for APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Apenas saída. Payload do evento de inicialização do app.Presente apenas quando eventType é 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 Directory API do dispositivo. Esse valor é igual ao 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.

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. 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 de HTTPs será executada periodicamente, e TelemetryHttpsLatencyChangeEvent será 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 de 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 Latência de HTTPS recuperada de um problema.
PROBLEM Problema de latência de HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent é acionado quando há eventos de intensidade do sinal de 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)

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 dele.
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.

ApplicationInstallSource

Descreve a origem de instalação do app.

Enums
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 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 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 por sincronização.
APPLICATION_INSTALL_REASON_USER Aplicativo instalado por ação do usuário.
APPLICATION_INSTALL_REASON_SUB_APP Aplicativo instalado por chamada de API SubApp.
APPLICATION_INSTALL_REASON_KIOSK Aplicativo instalado por 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 da desinstalaçã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.

ApplicationUninstallSource

Descreve a origem de desinstalação do app.

Enums
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Origem de desinstalação do app desconhecida.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Aplicativo desinstalado da lista de apps (tela de início).
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.

TelemetryAppLaunchEvent

Dados de inicialização do app.

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

enum (ApplicationLaunchSource)

Fonte 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 Fonte de inicialização do app 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 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 lançado a partir de recomendações sem consulta (ícones menores).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS O app é iniciado na seção "Configurações do controle da família" e na notificação "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 inserir um URL na omnibox no navegador.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Aplicativo iniciado em uma chamada interna do Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Aplicativo iniciado pelo atalho de teclado para abrir o aplicativo.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Aplicativo iniciado ao clicar em um link em outro aplicativo ou WebUI.
APPLICATION_LAUNCH_SOURCE_MENU Aplicativo iniciado no menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Aplicativo iniciado a partir da notificação instalada.
APPLICATION_LAUNCH_SOURCE_TEST Aplicativo iniciado a partir de um teste.
APPLICATION_LAUNCH_SOURCE_ARC Aplicativo iniciado no Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Aplicativo iniciado do Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Aplicativo iniciado a partir da notificação de notas da versão.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Aplicativo iniciado a partir 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 a partir de uma notificação da guia de descoberta.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Aplicativo iniciado a partir da API de gerenciamento.
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 no 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 do Login do SO.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Aplicativo iniciado a partir do gerenciador de protocolo.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Aplicativo iniciado do gerenciador de URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Aplicativo iniciado no Acesso rápido aos apps na tela de bloqueio.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Aplicativo iniciado na página inicial do aplicativo (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Aplicativo iniciado ao mover conteúdo para um aplicativo.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU App iniciado no menu do perfil da WebUI chrome://password-manager instalável.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Aplicativo iniciado da agenda da bandeja do sistema.
APPLICATION_LAUNCH_SOURCE_INSTALLER Aplicativo iniciado 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 lançado após o tour de boas-vindas.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Aplicativo iniciado no painel de foco.
APPLICATION_LAUNCH_SOURCE_SPARKY Aplicativo lançado com base no recurso experimental Sparky.

Métodos

list

 Listar eventos de telemetria.