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)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  }
}
الحقول
name

string

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

object (TelemetryDeviceInfo)

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

object (TelemetryUserInfo)

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

string (Timestamp format)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
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)

النتائج فقط. الحمولة لأحداث قوة إشارة شبكة Wi-Fi لا يتم عرض القيمة إلا عندما تكون 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.
osCrashEvent

object (TelemetryOsCrashEvent)

النتائج فقط. الحمولة لحدث تعطُّل نظام التشغيل لا يتم عرض القيمة إلا عندما تكون eventType هي OS_CRASH.

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 عند حدوث أحداث قوة إشارة شبكة Wi-Fi.

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

رقم تعريف التطبيق بالنسبة إلى تطبيقات الويب التقدّمية، يكون هذا هو عنوان 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 تم تثبيت التطبيق من خلال طلب بيانات من واجهة برمجة التطبيقات SubApp.
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

رقم تعريف التطبيق بالنسبة إلى تطبيقات الويب التقدّمية، يكون هذا هو عنوان 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

رقم تعريف التطبيق بالنسبة إلى تطبيقات الويب التقدّمية، يكون هذا هو عنوان 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 التطبيق الذي تم تشغيله من خلال النقر على رابط في تطبيق آخر أو واجهة مستخدم ويب
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 لطلب
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 تم تشغيل التطبيق من قائمة الملف الشخصي لواجهة مستخدم 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.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING التطبيق الذي تم تشغيله من عملية تسجيل التنقّل
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API تم تشغيل التطبيق من واجهة برمجة التطبيقات web install API.

TelemetryOsCrashEvent

بيانات أعطال نظام التشغيل

تمثيل JSON 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
الحقول
crashType

enum (CrashType)

نوع العُطل
sessionType

enum (SessionType)

نوع الجلسة
crashId

string

معرّف العُطل

CrashType

يصف نوع العُطل.

عمليات التعداد
CRASH_TYPE_UNSPECIFIED نوع العُطل غير معروف.
CRASH_TYPE_KERNEL تعطُّل نواة النظام
CRASH_TYPE_EMBEDDED_CONTROLLER تعطُّل جهاز التحكّم المضمّن

SessionType

يصف نوع الجلسة.

عمليات التعداد
SESSION_TYPE_UNSPECIFIED نوع الجلسة غير معروف.
SESSION_TYPE_SIGNED_IN_USER المستخدِم الذي سجَّل الدخول
SESSION_TYPE_KIOSK وضع الكشك (العرض التوضيحي).
SESSION_TYPE_MANAGED_GUEST جلسة الضيف المُدارة
SESSION_TYPE_ACTIVE_DIRECTORY جلسة Active Directory

الطُرق

list

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