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

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

integer

اختياريّ. الحد الأقصى لعدد النتائج المطلوب عرضها. القيمة التلقائية هي 100. الحدّ الأقصى للقيمة هو 1,000.
pageToken

string

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

نص الطلب

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

نص الاستجابة

رسالة استجابة لإدراج أحداث القياس عن بُعد لأحد العملاء.

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

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

object (TelemetryEvent)

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

string

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

نطاقات التفويض

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

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