Method: customers.telemetry.users.list

إدراج جميع مستخدمي ميزة "قياس البيانات عن بُعد"

طلب HTTP

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

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

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

المعلمات
parent

string

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

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

المعلمات
filter

string

لا تُدرِج سوى المراجع التي تتطابق مع الفلتر.

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

  • userId
  • userOrgUnitId

readMask

string (FieldMask format)

قراءة القناع لتحديد الحقول المطلوب عرضها

مسارات readMask المتوافقة هي:

  • الاسم
  • orgUnitId
  • userId
  • userEmail
  • userDevice.device_id
  • userDevice.audio_status_report
  • userDevice.device_activity_report
  • userDevice.network_bandwidth_report
  • userDevice.peripherals_report
  • userDevice.app_report

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

pageSize

integer

تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. القيمة التلقائية هي 100. الحد الأقصى للقيمة هو 1,000.

pageToken

string

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

نص الطلب

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

نص الاستجابة

رسالة ردّ بشأن إدراج مستخدمي بيانات القياس عن بُعد لأحد العملاء

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

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

object (TelemetryUser)

مستخدمو بيانات التتبُّع الذين تم إرجاعهم في الاستجابة

nextPageToken

string

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

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

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

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