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

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