Method: customers.telemetry.devices.list

عرض قائمة بجميع أجهزة القياس عن بُعد

طلب HTTP

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

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

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

المعلمات
parent

string

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

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

المعلمات
filter

string

اختياريّ. يجب تضمين الموارد التي تتطابق مع الفلتر فقط. إنّ الطلبات التي لا تحدّد قيمة "reports_timestamp" ستؤدي تلقائيًا إلى عرض التقارير الأخيرة فقط. حدِّد "reports_timestamp>=0" للحصول على جميع بيانات التقارير.

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

  • orgUnitId
  • serialNumber
  • deviceId
  • reports_timestamp
يقبل الفلتر reports_timestamp إما تنسيق Unix Epoch بالملي ثانية أو تنسيق RFC3339 UTC "Zulu" بدقة نانو ثانية وما يصل إلى تسعة أرقام عشرية. يجب أن يكون كلا التنسيقَين محاطَين بعلامتَي اقتباس مزدوجتَين بسيطتَين. على سبيل المثال: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z" و"1679283943823".
readMask

string (FieldMask format)

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

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

  • الاسم
  • orgUnitId
  • deviceId
  • serialNumber
  • cpuInfo
  • cpuStatusReport
  • memoryInfo
  • memoryStatusReport
  • networkInfo
  • networkDiagnosticsReport
  • networkStatusReport
  • osUpdateStatus
  • graphicsInfo
  • graphicsStatusReport
  • batteryInfo
  • batteryStatusReport
  • storageInfo
  • storageStatusReport
  • thunderboltInfo
  • audioStatusReport
  • bootPerformanceReport
  • heartbeatStatusReport
  • networkBandwidthReport
  • peripheralsReport
  • kioskAppStatusReport
  • appReport
  • runtimeCountersReport

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

integer

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

string

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

نص الطلب

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

نص الاستجابة

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

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

object (TelemetryDevice)

أجهزة القياس عن بُعد التي تم عرضها في الاستجابة
nextPageToken

string

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

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

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

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