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)
  }
}
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 UTC "Zulu" RFC3339, 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.

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.

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

Métodos

list

 Lista eventos de telemetria.