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