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)
  },
  "appInstallEvent": {
    object (TelemetryAppInstallEvent)
  },
  "appUninstallEvent": {
    object (TelemetryAppUninstallEvent)
  },
  "appLaunchEvent": {
    object (TelemetryAppLaunchEvent)
  }
}
الحقول
name

string

النتائج فقط. اسم مورد الحدث.
device

object (TelemetryDeviceInfo)

النتائج فقط. معلومات حول الجهاز المرتبط بالحدث.
user

object (TelemetryUserInfo)

النتائج فقط. معلومات حول المستخدم المرتبط بالحدث.
reportTime

string (Timestamp format)

طابع زمني يمثّل وقت الإبلاغ عن الحدث

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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.
appInstallEvent

object (TelemetryAppInstallEvent)

النتائج فقط. الحمولة لحدث تثبيت التطبيق مشاركة العرض فقط عندما تكون قيمة eventType هي APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

النتائج فقط. البيانات الأساسية لحدث إلغاء تثبيت التطبيق مشاركة العرض فقط عندما تكون قيمة eventType هي APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

النتائج فقط. حمولة حدث إطلاق التطبيق.لا تظهر إلا عند بلوغ eventType APP_LAUNCHED.

TelemetryDeviceInfo

معلومات حول جهاز مرتبط ببيانات القياس عن بُعد.

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

string

النتائج فقط. المعرّف الفريد لواجهة برمجة تطبيقات الدليل للجهاز. هذه القيمة هي نفسها رقم تعريف 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

تتم إضافة أو إزالة أجهزة USB التي يتم تشغيلها من قِبل "TelemetryUsbPeripheralsEvent".

  • مطلوب إذن دقيق: 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 لقوة الإشارة

TelemetryAppInstallEvent

بيانات تثبيت التطبيق

تمثيل JSON 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
الحقول
appInstallSource

enum (ApplicationInstallSource)

مصدر تثبيت التطبيق.
appInstallReason

enum (ApplicationInstallReason)

سبب تثبيت التطبيق.
appInstallTime

enum (ApplicationInstallTime)

يعتمد وقت تثبيت التطبيق على دورة حياة التطبيق.
appId

string

رقم تعريف التطبيق بالنسبة إلى تطبيقات الويب التقدّمية (PWA)، هذا هو عنوان URL للبدء، وبالنسبة إلى الإضافات هذا هو معرّف الإضافة.
appType

enum (TelemetryApplicationType)

نوع التطبيق.

ApplicationInstallSource

وصف مصدر تثبيت التطبيق

عمليات التعداد
APPLICATION_INSTALL_SOURCE_UNSPECIFIED مصدر تثبيت التطبيق غير معروف.
APPLICATION_INSTALL_SOURCE_SYSTEM تم تثبيت التطبيق كجزء من نظام التشغيل Chrome.
APPLICATION_INSTALL_SOURCE_SYNC مصدر تثبيت التطبيق هو مزامنة.
APPLICATION_INSTALL_SOURCE_PLAY_STORE مصدر تثبيت التطبيق هو متجر Play.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE مصدر تثبيت التطبيق هو سوق Chrome الإلكتروني.
APPLICATION_INSTALL_SOURCE_BROWSER مصدر تثبيت التطبيق هو المتصفح.

ApplicationInstallReason

يصف هذا العمود سبب تثبيت التطبيق.

عمليات التعداد
APPLICATION_INSTALL_REASON_UNSPECIFIED سبب تثبيت التطبيق غير معروف.
APPLICATION_INSTALL_REASON_SYSTEM تطبيق مثبَّت من خلال النظام ويتم اعتباره جزءًا من نظام التشغيل.
APPLICATION_INSTALL_REASON_POLICY تم تثبيت التطبيق من خلال السياسة.
APPLICATION_INSTALL_REASON_OEM تم تثبيت التطبيق من قِبل شركة مصنّعة أصلية للأجهزة (OEM).
APPLICATION_INSTALL_REASON_DEFAULT تطبيق مثبَّت تلقائيًا، ولكنه لا يُعتبَر تطبيق نظام.
APPLICATION_INSTALL_REASON_SYNC تم تثبيت التطبيق من خلال المزامنة.
APPLICATION_INSTALL_REASON_USER تم تثبيت التطبيق من خلال إجراء المستخدم.
APPLICATION_INSTALL_REASON_SUB_APP تم تثبيت التطبيق لطلب البيانات من واجهة برمجة التطبيقات bt SubApp API.
APPLICATION_INSTALL_REASON_KIOSK تم تثبيت التطبيق من خلال Kiosk على نظام التشغيل Chrome.
APPLICATION_INSTALL_REASON_COMMAND_LINE تم تثبيت التطبيق باستخدام وسيطة سطر الأوامر.

ApplicationInstallTime

يتم وصف وقت تثبيت التطبيق بناءً على دورة حياة التطبيق.

عمليات التعداد
APPLICATION_INSTALL_TIME_UNSPECIFIED وقت تثبيت التطبيق غير معروف.
APPLICATION_INSTALL_TIME_INIT تم إعداد تثبيت التطبيق.
APPLICATION_INSTALL_TIME_RUNNING تثبيت التطبيق قيد التشغيل حاليًا.

TelemetryAppUninstallEvent

بيانات إلغاء تثبيت التطبيق

تمثيل JSON 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
الحقول
appUninstallSource

enum (ApplicationUninstallSource)

مصدر إلغاء تثبيت التطبيق.
appId

string

رقم تعريف التطبيق بالنسبة إلى تطبيقات الويب التقدّمية (PWA)، هذا هو عنوان URL للبدء، وبالنسبة إلى الإضافات هذا هو معرّف الإضافة.
appType

enum (TelemetryApplicationType)

نوع التطبيق.

ApplicationUninstallSource

وصف مصدر إلغاء تثبيت التطبيق

عمليات التعداد
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED مصدر إلغاء تثبيت التطبيق غير معروف.
APPLICATION_UNINSTALL_SOURCE_APP_LIST تم إلغاء تثبيت التطبيق من قائمة التطبيقات (مشغّل التطبيقات).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT تم إلغاء تثبيت التطبيق من صفحة "إدارة التطبيقات".
APPLICATION_UNINSTALL_SOURCE_SHELF تم إلغاء تثبيت التطبيق من الرف.
APPLICATION_UNINSTALL_SOURCE_MIGRATION تم إلغاء تثبيت التطبيق بسبب نقل بيانات التطبيق.

TelemetryAppLaunchEvent

بيانات تشغيل التطبيق

تمثيل JSON 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
الحقول
appLaunchSource

enum (ApplicationLaunchSource)

مصدر تشغيل التطبيق.
appId

string

رقم تعريف التطبيق بالنسبة إلى تطبيقات الويب التقدّمية (PWA)، هذا هو عنوان URL للبدء، وبالنسبة إلى الإضافات هذا هو معرّف الإضافة.
appType

enum (TelemetryApplicationType)

نوع التطبيق.

ApplicationLaunchSource

تصف مصدر تشغيل التطبيق.

عمليات التعداد
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED مصدر تشغيل التطبيق غير معروف.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID يتم تشغيل التطبيق من شبكة التطبيقات، وليس من مربّع البحث.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU تم تشغيل التطبيق من شبكة التطبيقات، خارج قائمة السياقات.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY تم تشغيل التطبيق من نتائج تعتمد على طلب البحث (رموز أكبر).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU تم تشغيل التطبيق من نتائج تعتمد على طلب البحث، خارج قائمة السياقات.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION تم تشغيل التطبيق من اقتراحات أقل من طلبات البحث (رموز أصغر).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS تم تشغيل التطبيق من قسم إعدادات رقابة الأهل والإشعار حسب وقت كل تطبيق.
APPLICATION_LAUNCH_SOURCE_SHELF تم تشغيل التطبيق من الرف.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER تم تشغيل التطبيق من مدير الملفات
APPLICATION_LAUNCH_SOURCE_OMNIBOX تم تشغيل التطبيق من إدخال عنوان URL في المربّع المتعدد الاستخدامات على المتصفِّح.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL تم تشغيل التطبيق من مكالمة داخلية في Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD تم تشغيل التطبيق من اختصار لوحة المفاتيح لفتح التطبيق.
APPLICATION_LAUNCH_SOURCE_OTHER_APP تم تشغيل التطبيق من خلال النقر على رابط في تطبيق آخر أو في WebUI.
APPLICATION_LAUNCH_SOURCE_MENU تم تشغيل التطبيق من القائمة.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION تم تشغيل التطبيق من الإشعار المثبّت.
APPLICATION_LAUNCH_SOURCE_TEST تم تشغيل التطبيق من اختبار.
APPLICATION_LAUNCH_SOURCE_ARC تم تشغيل التطبيق من Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET تم تشغيل التطبيق من "قائمة مشاركة البيانات".
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION تم تشغيل التطبيق من إشعار ملاحظات الإصدار.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE تم تشغيل التطبيق من استعادة كاملة.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU تم تشغيل التطبيق من قائمة سياقات لاختيار النص الذكي.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION تم تشغيل التطبيق من إشعار علامة تبويب "استكشاف".
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API تم تشغيل التطبيق من Management API.
APPLICATION_LAUNCH_SOURCE_KIOSK تم تشغيل التطبيق من Kiosk.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE تم تشغيل التطبيق من سطر الأوامر.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE تم تشغيل التطبيق من وضع الخلفية.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE تم تشغيل التطبيق من صفحة علامة تبويب جديدة.
APPLICATION_LAUNCH_SOURCE_INTENT_URL تم تشغيل التطبيق من عنوان URL لـ intent.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN تم تشغيل التطبيق بعد تسجيل الدخول إلى نظام التشغيل.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER تم تشغيل التطبيق من معالج البروتوكول.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER تم تشغيل التطبيق من معالج عناوين URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN تم تشغيل التطبيق من مشغّل تطبيقات شاشة القفل.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE تم تشغيل التطبيق من صفحة التطبيق الرئيسية (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING تم تشغيل التطبيق من نقل محتوى إلى تطبيق.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU تم تشغيل التطبيق من قائمة الملف الشخصي في واجهة WebUI chrome://password-manager القابلة للتثبيت.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR تم تشغيل التطبيق من تقويم لوحة النظام.
APPLICATION_LAUNCH_SOURCE_INSTALLER تم تشغيل التطبيق من أداة التثبيت المصدر.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN احتساب عدد عمليات تشغيل تطبيق المساعدة التي يتم تشغيلها لأول مرة بشكل منفصل حتى نتمكن من معرفة عدد عمليات الإطلاق التي يشغّلها المستخدم
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR تم بدء التطبيق من جولة ترحيبية.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE تم تشغيل التطبيق من لوحة التركيز.
APPLICATION_LAUNCH_SOURCE_SPARKY تم تشغيل التطبيق من الميزة التجريبية Sparky.

الطُرق

list

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