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 الخاص بالجهاز. هذه القيمة هي نفسها رقم تعريف 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

 إدراج جميع مستخدمي ميزة "قياس البيانات عن بُعد"