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 "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".
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. هذه القيمة هي نفسها رقم تعريف 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 لقوة الإشارة

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 تم تشغيل التطبيق من 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 تم تشغيل التطبيق من قائمة الملف الشخصي في واجهة 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 تم إطلاق التطبيق من لوحة التركيز.

الطُرق

list

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