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)

النتائج فقط. حمولة حدث أجهزة ملحقة بمنفذ 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. هذه القيمة هي نفسها رقم تعريف Directory API في "وحدة تحكّم المشرف" في علامة التبويب "أجهزة ChromeOS".
orgUnitId

string

النتائج فقط. رقم تعريف الوحدة التنظيمية للجهاز.

TelemetryUserInfo

معلومات حول مستخدِم مرتبط ببيانات القياس عن بُعد

  • مطلوب إذن دقيق: TELEMETRY_API_USER
تمثيل JSON 
{
  "email": string,
  "orgUnitId": string
}
الحقول
email

string

النتائج فقط. عنوان البريد الإلكتروني للمستخدم
orgUnitId

string

النتائج فقط. رقم تعريف الوحدة التنظيمية للمستخدِم.

TelemetryAudioSevereUnderrunEvent

لا يشتمل هذا النوع على أي حقول.

يتم تشغيل TelemetryAudioSevereUnderrunEvent عند نفاد بيانات التخزين المؤقت على الأجهزة الصوتية لمدة تزيد عن 5 ثوانٍ.

  • يلزم الحصول على إذن دقيق: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

يتم تشغيل "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

عمليات التعداد
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

 إدراج أحداث القياس عن بُعد