REST Resource: customers.telemetry.events

משאב: TelemetryEvent

נתוני טלמטריה שדווחו על ידי מכשיר מנוהל.

ייצוג JSON 
{
  "name": string,
  "device": {
    object (TelemetryDeviceInfo)
  },
  "user": {
    object (TelemetryUserInfo)
  },
  "reportTime": string,
  "eventType": enum (EventType),
  "audioSevereUnderrunEvent": {
    object (TelemetryAudioSevereUnderrunEvent)
  },
  "usbPeripheralsEvent": {
    object (TelemetryUsbPeripheralsEvent)
  },
  "networkStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  },
  "httpsLatencyChangeEvent": {
    object (TelemetryHttpsLatencyChangeEvent)
  },
  "wifiSignalStrengthEvent": {
    object (TelemetryNetworkSignalStrengthEvent)
  },
  "vpnConnectionStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  }
}
שדות
name

string

פלט בלבד. שם המשאב של האירוע.
device

object (TelemetryDeviceInfo)

פלט בלבד. מידע על המכשיר שמשויך לאירוע.
user

object (TelemetryUserInfo)

פלט בלבד. מידע על המשתמש שמשויך לאירוע.
reportTime

string (Timestamp format)

חותמת זמן שמייצגת את מועד הדיווח על האירוע.

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

enum (EventType)

סוג האירוע של האירוע הנוכחי.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

פלט בלבד. מטען ייעודי (payload) לאירוע אודיו תת-קרקעי חמור. יוצג רק אם השדה eventType הוא AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

פלט בלבד. מטען ייעודי (payload) לאירוע של ציוד היקפי בחיבור USB. יוצג רק אם השדה eventType הוא USB_ADDED או USB_REMOVED.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

פלט בלבד. אירוע שינוי מצב החיבור לרשת מטען ייעודי (payload). הצגה רק כשהערך של eventType הוא NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

פלט בלבד. מטען ייעודי (payload) לאירוע שינוי של זמן אחזור של HTTPS. הצגה רק כשהערך של eventType הוא NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

פלט בלבד. מטען ייעודי (payload) לאירועים של עוצמת אות ה-Wi-Fi. הצגה רק כשהערך של eventType הוא WIFI_SIGNAL_STRENGTH_LOW או WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

פלט בלבד. אירוע שינוי מצב החיבור ל-VPN של המטען הייעודי (payload). הצגה רק כשהערך של eventType הוא VPN_CONNECTION_STATE_CHANGE.

TelemetryDeviceInfo

מידע על מכשיר שמשויך לנתוני טלמטריה.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_DEVICE
ייצוג JSON 
{
  "deviceId": string,
  "orgUnitId": string
}
שדות
deviceId

string

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

string

פלט בלבד. מזהה היחידה הארגונית של המכשיר.

TelemetryUserInfo

מידע על משתמש שמשויך לנתוני טלמטריה.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_USER
ייצוג JSON 
{
  "email": string,
  "orgUnitId": string
}
שדות
email

string

פלט בלבד. כתובת האימייל של המשתמש.
orgUnitId

string

פלט בלבד. מזהה היחידה הארגונית של המשתמש.

TelemetryAudioSevereUnderrunEvent

אין שדות בסוג הזה.

הפקודה TelemetryAudioSevereUnderrunEvent מופעלת כשאוזלים הנתונים של מאגר הנתונים הזמני במכשירי אודיו למשך יותר מ-5 שניות.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

הופעל הוספה או הסרה של התקני USB של TelemetryUsbPeripheralsEvent.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_PERIPHERALS_REPORT
ייצוג JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
שדות
usbPeripheralReport[]

object (UsbPeripheralReport)

רשימה של מכשירי USB שנוספו או הוסרו.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent מופעל בשינויים במצב החיבור לרשת.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_NETWORK_REPORT
ייצוג JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
שדות
guid

string

המזהה הייחודי של הרשת.
connectionState

enum (NetworkConnectionState)

מצב החיבור הנוכחי לרשת.

TelemetryHttpsLatencyChangeEvent

תרחיש זמן האחזור של Https מופעל מדי פעם ו-TelemetryHttpsLatencyChangeEvent מופעל אם זוהתה בעיית זמן אחזור או אם המכשיר התאושש מבעיית זמן אחזור.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_NETWORK_REPORT
ייצוג JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
שדות
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

נתונים בתרחיש זמן אחזור של HTTPS שהפעילו את האירוע.
httpsLatencyState

enum (HttpsLatencyState)

מצב זמן האחזור הנוכחי של HTTPS.

HttpsLatencyState

מצב זמן אחזור של HTTPS.

טיפוסים בני מנייה (enums)
HTTPS_LATENCY_STATE_UNSPECIFIED לא צוין מצב זמן אחזור של HTTPS.
RECOVERY זמן האחזור של HTTPS שוחזר עקב בעיה.
PROBLEM יש בעיה בזמן האחזור של HTTPS.

TelemetryNetworkSignalStrengthEvent

הפקודה TelemetryNetworkSignalStrengthEvent מופעלת באירועים של עוצמת אות Wi-Fi.

  • נדרשת הרשאה מפורטת: TELEMETRY_API_NETWORK_REPORT
ייצוג JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
שדות
guid

string

המזהה הייחודי של הרשת.
signalStrengthDbm

integer

ערך RSSI של עוצמת האות.

שיטות

list

 הצגת רשימה של אירועי טלמטריה.