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