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)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
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 padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes 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 do evento atual.

audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

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

usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

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

networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Apenas saída. Payload para 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 evento de mudança de 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. Presente apenas quando eventType é WIFI_SIGNAL_STRENGTH_LOW ou WIFI_SIGNAL_STRENGTH_RECOVERED.

vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Apenas saída. Payload para 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 para evento de instalação de app. Presente somente quando eventType é APP_INSTALLED.

appUninstallEvent

object (TelemetryAppUninstallEvent)

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

appLaunchEvent

object (TelemetryAppLaunchEvent)

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

osCrashEvent

object (TelemetryOsCrashEvent)

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

externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

Apenas saída. Payload para evento de conexão/desconexão de tela externa. Presente apenas quando eventType é EXTERNAL_DISPLAY_CONNECTED ou EXTERNAL_DISPLAY_DISCONNECTED.

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 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 que foram 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 de rede.

TelemetryHttpsLatencyChangeEvent

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

  • 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 de HTTPS.

HttpsLatencyState

Estado da latência de HTTPS.

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

appId

string

ID do app. Para PWAs, esse é o URL de inicialização, e para extensões, é o ID da extensão.

appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationInstallSource

Descreve a origem da 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 O aplicativo foi instalado com o sistema e é considerado parte do SO.
APPLICATION_INSTALL_REASON_POLICY O app foi instalado por uma 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 Aplicativo instalado por sincronização.
APPLICATION_INSTALL_REASON_USER Aplicativo instalado por ação do usuário.
APPLICATION_INSTALL_REASON_SUB_APP Aplicativo instalado pela chamada de API SubApp.
APPLICATION_INSTALL_REASON_KIOSK Aplicativo instalado pelo quiosque no Chrome OS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Aplicativo instalado por argumento de 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 foi inicializada.
APPLICATION_INSTALL_TIME_RUNNING A instalação do aplicativo está em andamento.

TelemetryAppUninstallEvent

Dados de desinstalação de apps.

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 de inicialização, e para extensões, é 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 O aplicativo foi desinstalado da lista de apps (Acesso rápido aos apps).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT O aplicativo foi desinstalado na página "Gerenciamento de apps".
APPLICATION_UNINSTALL_SOURCE_SHELF O aplicativo foi desinstalado da estante.
APPLICATION_UNINSTALL_SOURCE_MIGRATION O aplicativo foi desinstalado pela migração de apps.

TelemetryAppLaunchEvent

Dados de inicialização de apps.

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

enum (ApplicationLaunchSource)

Origem do lançamento do app.

appId

string

ID do app. Para PWAs, esse é o URL de inicialização, e para extensões, é o ID da extensão.

appType

enum (TelemetryApplicationType)

Tipo de app.

ApplicationLaunchSource

Descreve a origem do início do app.

Tipos enumerados
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Origem do início 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 Aplicativo iniciado na grade de apps, fora do menu de contexto.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Aplicativo iniciado com base em resultados dependentes de consultas (ícones maiores).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU O aplicativo foi iniciado no menu de contexto com base em resultados dependentes de consultas.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Aplicativo iniciado com recomendações sem consulta (ícones menores).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Aplicativo iniciado na seção "Configurações do controle da família" e notificação de tempo por app.
APPLICATION_LAUNCH_SOURCE_SHELF O aplicativo foi iniciado na estante.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Aplicativo iniciado no gerenciador de arquivos
APPLICATION_LAUNCH_SOURCE_OMNIBOX O aplicativo foi iniciado ao inserir um URL na omnibox do navegador.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Aplicativo iniciado em uma chamada interna do Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Aplicativo iniciado com um atalho de teclado para abrir o app.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Aplicativo iniciado ao clicar em um link em outro app ou interface da Web.
APPLICATION_LAUNCH_SOURCE_MENU O aplicativo foi iniciado no menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION O app foi iniciado na notificação instalada.
APPLICATION_LAUNCH_SOURCE_TEST O aplicativo foi iniciado em um teste.
APPLICATION_LAUNCH_SOURCE_ARC O aplicativo foi iniciado no Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET O aplicativo foi iniciado na planilha de compartilhamento.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION O aplicativo foi iniciado na notificação das notas da versão.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE O aplicativo foi iniciado de uma restauração completa.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Aplicativo iniciado em um menu de contexto de seleção de texto inteligente.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION O aplicativo foi iniciado 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 iniciado na página "Nova guia".
APPLICATION_LAUNCH_SOURCE_INTENT_URL O aplicativo foi iniciado de um URL de intent.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Aplicativo iniciado pelo login do SO.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Aplicativo iniciado pelo gerenciador de protocolos.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Aplicativo iniciado pelo gerenciador de URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Aplicativo iniciado no acesso rápido da tela de bloqueio.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Aplicativo iniciado na página inicial do app (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Aplicativo iniciado ao mover conteúdo para um app.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Aplicativo iniciado no menu de perfil da WebUI instalável chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR O aplicativo foi iniciado no calendário 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 Ajuda na primeira execução separadamente para entendermos o número de inicializações acionadas pelo usuário.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR O aplicativo foi aberto no tour de boas-vindas.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE O aplicativo foi iniciado no painel de foco.
APPLICATION_LAUNCH_SOURCE_SPARKY O aplicativo foi iniciado com o recurso experimental Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Aplicativo iniciado pela captura de navegação.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Aplicativo iniciado pela API de instalação da Web.

TelemetryOsCrashEvent

Dados de falhas no 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.

Tipos enumerados
CRASH_TYPE_UNSPECIFIED Tipo de falha desconhecido.
CRASH_TYPE_KERNEL Falha do kernel.
CRASH_TYPE_EMBEDDED_CONTROLLER Falha do controlador incorporado.

SessionType

Descreve o tipo de sessão.

Tipos enumerados
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.

TelemetryExternalDisplayEvent

Payload de evento de conexão/desconexão de tela externa.

Representação JSON
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
Campos
externalDisplayData[]

object (TelemetryExternalDisplayData)

Lista de telas externas que foram conectadas/desconectadas.

TelemetryExternalDisplayData

Dados de exibição externa.

Representação JSON
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
Campos
displayName

string

O nome de exibição.

resolutionHorizontal

integer

A resolução horizontal.

resolutionVertical

integer

A resolução vertical.

refreshRate

string (int64 format)

A taxa de atualização.

serialNumber

integer

O número de série.

edidVersion

string

A versão do EDID.

Métodos

list

Listar eventos de telemetria.