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 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים מלבד 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

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