REST Resource: customers.telemetry.users

المورد: TelemetryUser

بيانات القياس عن بُعد التي يتم جمعها من حساب مُدار.

  • الإذن الدقيق المطلوب: TELEMETRY_API_USER
تمثيل JSON 
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "userId": string,
  "userEmail": string,
  "userDevice": [
    {
      object (TelemetryUserDevice)
    }
  ]
}
الحقول
name

string

اسم مورد المستخدم.
customer

string

عميل G Suite الذي سجّلت مؤسسته الجهاز.
orgUnitId

string

الوحدة التنظيمية للمستخدم.
userId

string

رقم تعريف المستخدم في دليل المستخدمين.
userEmail

string

عنوان البريد الإلكتروني للمستخدم.
userDevice[]

object (TelemetryUserDevice)

بيانات القياس عن بُعد التي يتم جمعها من حساب مُدار وجهاز.

TelemetryUserDevice

بيانات القياس عن بُعد التي يتم جمعها لحساب مُدار وجهاز.

  • الإذن الدقيق المطلوب: TELEMETRY_API_DEVICE
تمثيل JSON 
{
  "deviceId": string,
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "deviceActivityReport": [
    {
      object (DeviceActivityReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ]
}
الحقول
deviceId

string

رقم تعريف الجهاز الفريد في دليل المستخدمين. هذه القيمة هي نفسها معرّف Directory API في "وحدة تحكّم المشرف" ضمن علامة التبويب أجهزة ChromeOS.
audioStatusReport[]

object (AudioStatusReport)

النتائج فقط. تقارير الصوت التي يتم جمعها بشكلٍ دوري، مرتّبة تنازليًا حسب reportTime.
deviceActivityReport[]

object (DeviceActivityReport)

النتائج فقط. تقارير نشاط الجهاز التي يتم جمعها بشكلٍ دوري، مرتّبة تنازليًا حسب reportTime.
networkBandwidthReport[]

object (NetworkBandwidthReport)

النتائج فقط. تقارير النطاق الترددي للشبكة التي يتم جمعها بشكلٍ دوري، مرتّبة تنازليًا حسب reportTime.
peripheralsReport[]

object (PeripheralsReport)

النتائج فقط. تقارير الأجهزة الطرفية التي يتم جمعها بشكلٍ دوري، مرتّبة تنازليًا حسب reportTime.
appReport[]

object (AppReport)

النتائج فقط. تقارير التطبيقات التي يتم جمعها بشكلٍ دوري، مرتّبة تنازليًا حسب reportTime.

DeviceActivityReport

تقرير نشاط الجهاز.

  • الإذن الدقيق المطلوب: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "deviceActivityState": enum (DeviceActivityState)
}
الحقول
reportTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت جمع التقرير.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
deviceActivityState

enum (DeviceActivityState)

النتائج فقط. حالة نشاط الجهاز.

DeviceActivityState

حالة نشاط الجهاز.

عمليات التعداد
DEVICE_ACTIVITY_STATE_UNSPECIFIED حالة نشاط الجهاز غير محدّدة.
ACTIVE الجهاز قيد الاستخدام حاليًا.
IDLE الجهاز غير مستخدَم حاليًا.
LOCKED الجهاز مقفل حاليًا.

الطُرق

get

 الحصول على مستخدم القياس عن بُعد

list

 عرض قائمة بجميع مستخدمي القياس عن بُعد