Method: customers.telemetry.events.list

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

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
parent

string

الحقل مطلوب. رقم تعريف العميل أو my_customer لاستخدام العميل المرتبط بالحساب الذي يقدّم الطلب

مَعلمات طلب البحث

المعلمات
filter

string

اختياريّ. لا تدرِج سوى المراجع التي تتطابق مع الفلتر. على الرغم من أنّ هذه المَعلمة اختيارية في الوقت الحالي، سيصبح استخدامها إلزاميًا، لذا يُرجى تحديد نوع حدث واحد على الأقل.

حقول الفلاتر المتوافقة:

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • timestamp
  • eventType
يقبل الفلتر "الطابع الزمني" إما تنسيق Unix Epoch بالملي ثانية أو تنسيق RFC3339 UTC "Zulu"‎ بدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسرية. يجب أن يكون كلا التنسيقين محاطًا بعلامات اقتباس مزدوجة بسيطة. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z" و"1679283943823".
readMask

string (FieldMask format)

الحقل مطلوب. قناع القراءة لتحديد الحقول المطلوب عرضها على الرغم من أنّ هذا الحقل مطلوب حاليًا، سيصبح اختياريًا، بينما ستصبح مَعلمة الفلتر التي تتضمّن نوع حدث مطلوبة.

مسارات readMask المتاحة هي:

  • جهاز
  • المستخدم
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstallEvent
  • appUninstallEvent
  • appLaunchEvent
  • osCrashEvent
  • externalDisplaysEvent

هذه قائمة قيم مفصولة بفاصلة تتضمّن الأسماء المؤهَّلة بالكامل للحقول. مثال: "user.displayName,photo"
pageSize

integer

اختياريّ. تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. القيمة التلقائية هي 100. الحد الأقصى للقيمة هو 1000.
pageToken

string

اختياريّ. رمز مميز لتحديد الصفحة التالية في القائمة

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الردّ على أحداث قياس بيانات النشاط الخاصة بالعميل

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "telemetryEvents": [
    {
      object (TelemetryEvent)
    }
  ],
  "nextPageToken": string
}
الحقول
telemetryEvents[]

object (TelemetryEvent)

أحداث القياس عن بُعد التي تم عرضها في الردّ
nextPageToken

string

رمز مميز لتحديد الصفحة التالية في القائمة

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/chrome.management.telemetry.readonly