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

هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: "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