REST Resource: customers.telemetry.events

Ressource: TelemetryEvent

Telemetriedaten, die von einem verwalteten Gerät gemeldet werden.

JSON-Darstellung 
{
  "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)
  }
}
Felder
name

string

Nur Ausgabe Ressourcenname des Ereignisses.
device

object (TelemetryDeviceInfo)

Nur Ausgabe Informationen zu dem mit dem Ereignis verknüpften Gerät.
user

object (TelemetryUserInfo)

Nur Ausgabe Informationen über den mit dem Ereignis verknüpften Nutzer.
reportTime

string (Timestamp format)

Zeitstempel, der angibt, wann das Ereignis gemeldet wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
eventType

enum (EventType)

Der Ereignistyp des aktuellen Ereignisses.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Nur Ausgabe Nutzlast für ein schweres Unterlaufen der Audiospur. Ist nur vorhanden, wenn das Feld eventType den Wert AUDIO_SEVERE_UNDERRUN hat.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Nur Ausgabe Nutzlast für USB-Peripheriegeräte-Ereignis. Nur vorhanden, wenn das Feld eventType entweder USB_ADDED oder USB_REMOVED ist.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Nur Ausgabe Nutzlast für das Ereignis „Statusänderung der Netzwerkverbindung“. Nur präsentieren, wenn eventType den Wert NETWORK_STATE_CHANGE hat.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Nur Ausgabe Nutzlast für das HTTPS-Latenzereignisänderungsereignis. Nur präsentieren, wenn eventType den Wert NETWORK_HTTPS_LATENCY_CHANGE hat.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Nur Ausgabe Nutzlast für WLAN-Signalstärke-Ereignisse. Nur vorhanden, wenn eventType den Wert WIFI_SIGNAL_STRENGTH_LOW oder WIFI_SIGNAL_STRENGTH_RECOVERED hat.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Nur Ausgabe Nutzlast für das Ereignis „Änderung des VPN-Verbindungsstatus“. Nur präsentieren, wenn eventType den Wert VPN_CONNECTION_STATE_CHANGE hat.

TelemetryDeviceInfo

Informationen zu einem Gerät, das mit Telemetriedaten verknüpft ist.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_DEVICE
JSON-Darstellung 
{
  "deviceId": string,
  "orgUnitId": string
}
Felder
deviceId

string

Nur Ausgabe Die eindeutige Directory API-ID des Geräts. Dieser Wert entspricht der Directory API-ID der Admin-Konsole auf dem Tab „ChromeOS-Geräte“.
orgUnitId

string

Nur Ausgabe ID der Organisationseinheit des Geräts.

TelemetryUserInfo

Informationen zu einem Nutzer, die Telemetriedaten zugeordnet sind.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_USER
JSON-Darstellung 
{
  "email": string,
  "orgUnitId": string
}
Felder
email

string

Nur Ausgabe E-Mail-Adresse des Nutzers.
orgUnitId

string

Nur Ausgabe ID der Organisationseinheit des Nutzers.

TelemetryAudioSevereUnderrunEvent

Dieser Typ hat keine Felder.

TelemetryAudioSevereUnderrunEvent wird ausgelöst, wenn einem Audiogerät für mehr als 5 Sekunden keine Zwischenspeicherdaten mehr zur Verfügung stehen.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent ausgelöste USB-Geräte werden entweder hinzugefügt oder entfernt.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_PERIPHERALS_REPORT
JSON-Darstellung 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Felder
usbPeripheralReport[]

object (UsbPeripheralReport)

Liste der USB-Geräte, die entweder hinzugefügt oder entfernt wurden.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent wird bei Änderungen des Status der Netzwerkverbindung ausgelöst.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Felder
guid

string

Eindeutige Kennung des Netzwerks.
connectionState

enum (NetworkConnectionState)

Aktueller Verbindungsstatus des Netzwerks.

TelemetryHttpsLatencyChangeEvent

Die HTTPS-Latenzroutine wird regelmäßig ausgeführt und TelemetryHttpsLatencyChangeEvent wird ausgelöst, wenn ein Latenzproblem erkannt wurde oder wenn das Gerät ein Latenzproblem behoben hat.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Felder
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

HTTPS-Latenzroutinedaten, die das Ereignis ausgelöst haben.
httpsLatencyState

enum (HttpsLatencyState)

Aktueller HTTPS-Latenzstatus.

HttpsLatencyState

HTTPS-Latenzstatus.

Enums
HTTPS_LATENCY_STATE_UNSPECIFIED HTTPS-Latenzstatus ist nicht angegeben.
RECOVERY Die HTTPS-Latenz wurde aus einem Problem wiederhergestellt.
PROBLEM HTTPS-Latenzproblem.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent wird durch WLAN-Signalstärke ausgelöst.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_NETWORK_REPORT
JSON-Darstellung 
{
  "guid": string,
  "signalStrengthDbm": integer
}
Felder
guid

string

Eindeutige Kennung des Netzwerks.
signalStrengthDbm

integer

RSSI-Wert für die Signalstärke.

Methoden

list

 Telemetrieereignisse auflisten.