REST Resource: customers.telemetry.events

منبع: TelemetryEvent

داده های تله متری گزارش شده توسط یک دستگاه مدیریت شده.

نمایندگی 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)
  }
}
زمینه های
name

string

فقط خروجی نام منبع رویداد

device

object ( TelemetryDeviceInfo )

فقط خروجی اطلاعات مربوط به دستگاه مرتبط با رویداد.

user

object ( TelemetryUserInfo )

فقط خروجی اطلاعات مربوط به کاربر مرتبط با رویداد.

reportTime

string ( Timestamp format)

مهر زمانی که نشان دهنده زمان گزارش رویداد است.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

eventType

enum ( EventType )

نوع رویداد رویداد جاری.

audioSevereUnderrunEvent

object ( TelemetryAudioSevereUnderrunEvent )

فقط خروجی بارگذاری برای رویداد افت شدید صوتی. تنها زمانی ارائه شود که قسمت eventType AUDIO_SEVERE_UNDERRUN باشد.

usbPeripheralsEvent

object ( TelemetryUsbPeripheralsEvent )

فقط خروجی رویداد Payload برای وسایل جانبی usb. تنها زمانی ارائه شود که قسمت eventType یا USB_ADDED یا USB_REMOVED باشد.

networkStateChangeEvent

object ( TelemetryNetworkConnectionStateChangeEvent )

فقط خروجی بارگذاری برای رویداد تغییر وضعیت اتصال شبکه. تنها زمانی ارائه شود که eventType NETWORK_STATE_CHANGE باشد.

httpsLatencyChangeEvent

object ( TelemetryHttpsLatencyChangeEvent )

فقط خروجی بارگذاری برای رویداد تغییر تأخیر HTTPS. تنها زمانی ارائه شود که eventType NETWORK_HTTPS_LATENCY_CHANGE باشد.

wifiSignalStrengthEvent

object ( TelemetryNetworkSignalStrengthEvent )

فقط خروجی بار برای رویدادهای قدرت سیگنال WiFi. تنها زمانی ارائه شود که eventType WIFI_SIGNAL_STRENGTH_LOW یا WIFI_SIGNAL_STRENGTH_RECOVERED باشد.

vpnConnectionStateChangeEvent

object ( TelemetryNetworkConnectionStateChangeEvent )

فقط خروجی بارگذاری برای رویداد تغییر وضعیت اتصال VPN. تنها زمانی ارائه شود که eventType VPN_CONNECTION_STATE_CHANGE باشد.

TelemetryDeviceInfo

اطلاعات مربوط به یک دستگاه مرتبط با داده های تله متری.

  • مجوز ریز مورد نیاز: TELEMETRY_API_DEVICE
نمایندگی JSON
{
  "deviceId": string,
  "orgUnitId": string
}
زمینه های
deviceId

string

فقط خروجی شناسه منحصر به فرد Directory API دستگاه. این مقدار همان شناسه API راهنمای کنسول مدیریت در برگه دستگاه‌های ChromeOS است.

orgUnitId

string

فقط خروجی شناسه واحد سازمانی دستگاه.

TelemetryUserInfo

اطلاعات مربوط به یک کاربر مرتبط با داده های تله متری.

  • مجوز ریز مورد نیاز: TELEMETRY_API_USER
نمایندگی JSON
{
  "email": string,
  "orgUnitId": string
}
زمینه های
email

string

فقط خروجی ایمیل کاربر.

orgUnitId

string

فقط خروجی شناسه واحد سازمانی کاربر.

TelemetryAudioSevereUnderrunEvent

این نوع هیچ فیلدی ندارد.

TelemetryAudioSevereUnderrunEvent زمانی فعال می شود که دستگاه های صوتی بیش از 5 ثانیه از داده های بافر خالی شوند.

  • مجوز کلی مورد نیاز: TELEMETRY_API_AUDIO_REPORT

رویداد TelemetryUsbPeripherals

TelemetryUsbPeripheralsEvent فعال می شود دستگاه های USB یا اضافه یا حذف می شوند.

  • مجوز کلی مورد نیاز: TELEMETRY_API_PERIPHERALS_REPORT
نمایندگی JSON
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
زمینه های
usbPeripheralReport[]

object ( UsbPeripheralReport )

لیست دستگاه های USB که اضافه یا حذف شده اند.

رویداد TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent در تغییر وضعیت اتصال شبکه فعال می شود.

  • مجوز کلی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایندگی JSON
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
زمینه های
guid

string

شناسه منحصر به فرد شبکه

connectionState

enum ( NetworkConnectionState )

وضعیت اتصال فعلی شبکه

TelemetryHttpsLatencyChangeEvent

روال تأخیر Https به صورت دوره‌ای اجرا می‌شود و TelemetryHttpsLatencyChangeEvent در صورت شناسایی مشکل تأخیر یا بهبود دستگاه از مشکل تأخیر فعال می‌شود.

  • مجوز کلی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایندگی JSON
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
زمینه های
httpsLatencyRoutineData

object ( HttpsLatencyRoutineData )

داده‌های روتین تأخیر HTTPS که رویداد را راه‌اندازی کرد.

httpsLatencyState

enum ( HttpsLatencyState )

وضعیت تأخیر فعلی HTTPS.

HttpsLatencyState

وضعیت تأخیر HTTPS.

Enums
HTTPS_LATENCY_STATE_UNSPECIFIED وضعیت تأخیر HTTPS نامشخص است.
RECOVERY تأخیر HTTPS پس از یک مشکل بازیابی شد.
PROBLEM مشکل تأخیر HTTPS

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent در رویدادهای قدرت سیگنال WiFi فعال می شود.

  • مجوز کلی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایندگی JSON
{
  "guid": string,
  "signalStrengthDbm": integer
}
زمینه های
guid

string

شناسه منحصر به فرد شبکه

signalStrengthDbm

integer

قدرت سیگنال مقدار RSSI.

مواد و روش ها

list

 رویدادهای تله متری را فهرست کنید.