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