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)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
الحقول
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.
externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

النتائج فقط. الحِزمة لحدث توصيل/قطع الاتصال بشاشة عرض خارجية يجب تقديم هذه السمة فقط عندما تكون قيمة eventType هي EXTERNAL_DISPLAY_CONNECTED أو EXTERNAL_DISPLAY_DISCONNECTED.

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 تم تشغيل التطبيق من خلال واجهة برمجة التطبيقات الخاصة بالتثبيت من الويب.

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

TelemetryExternalDisplayEvent

حمولة حدث توصيل/قطع الاتصال بشاشة خارجية

تمثيل JSON 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
الحقول
externalDisplayData[]

object (TelemetryExternalDisplayData)

قائمة بالشاشات الخارجية التي تم توصيلها أو قطع الاتصال بها

TelemetryExternalDisplayData

بيانات العرض الخارجي

تمثيل JSON 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
الحقول
displayName

string

الاسم المعروض
resolutionHorizontal

integer

تمثّل هذه السمة درجة الدقة الأفقية.
resolutionVertical

integer

تمثّل هذه السمة الدقة العمودية.
refreshRate

string (int64 format)

معدّل إعادة التحميل
serialNumber

integer

الرقم التسلسلي
edidVersion

string

إصدار EDID

الطُرق

list

 تعرض هذه السياسة قائمة بأحداث القياس عن بُعد.