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 של מסוף Admin בכרטיסייה 'מכשירי 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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
deviceActivityState

enum (DeviceActivityState)

פלט בלבד. מצב הפעילות של המכשיר.

DeviceActivityState

מצב הפעילות של המכשיר.

טיפוסים בני מנייה (enum)
DEVICE_ACTIVITY_STATE_UNSPECIFIED מצב הפעילות של המכשיר לא צוין.
ACTIVE המכשיר נמצא בשימוש כרגע.
IDLE המכשיר לא פעיל כרגע.
LOCKED המכשיר נעול כרגע.

Methods

get

 אחזור משתמש של טלמטריה.

list

 הצגת רשימה של כל המשתמשים בטלמטריה.