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)
    }
  ]
}
שדות
deviceId

string

המזהה הייחודי של ה-Directory API של המכשיר. הערך הזה זהה למזהה ב-Directory API של מסוף Admin בכרטיסייה 'מכשירי ChromeOS'.
audioStatusReport[]

object (AudioStatusReport)

פלט בלבד. דוחות אודיו שנאספים מדי פעם ממוינים בסדר יורד של reportTime.
deviceActivityReport[]

object (DeviceActivityReport)

פלט בלבד. דוחות הפעילות במכשירים שנאספים מדי פעם ממוינים בסדר יורד של reportTime.
networkBandwidthReport[]

object (NetworkBandwidthReport)

פלט בלבד. דוחות על רוחב פס ברשת שנאספו מדי פעם ממוינים בסדר יורד של reportTime.
peripheralsReport[]

object (PeripheralsReport)

פלט בלבד. דוחות על ציוד היקפי שנאספים מדי פעם ממוינים בסדר יורד של reportTime.

DeviceActivityReport

דוח פעילות במכשיר.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
ייצוג JSON 
{
  "reportTime": string,
  "deviceActivityState": enum (DeviceActivityState)
}
שדות
reportTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של מועד איסוף הדוח.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
deviceActivityState

enum (DeviceActivityState)

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

DeviceActivityState

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

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

שיטות

get

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

list

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