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