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)
  },
  "appInstallEvent": {
    object (TelemetryAppInstallEvent)
  },
  "appUninstallEvent": {
    object (TelemetryAppUninstallEvent)
  },
  "appLaunchEvent": {
    object (TelemetryAppLaunchEvent)
  }
}
שדות
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.
appInstallEvent

object (TelemetryAppInstallEvent)

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

object (TelemetryAppUninstallEvent)

פלט בלבד. מטען ייעודי (payload) לאירוע של הסרת אפליקציה. הצגה רק כשהערך של eventType הוא APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

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

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 של עוצמת האות.

TelemetryAppInstallEvent

נתוני התקנה של האפליקציה.

ייצוג JSON 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
שדות
appInstallSource

enum (ApplicationInstallSource)

המקור להתקנת האפליקציה.
appInstallReason

enum (ApplicationInstallReason)

הסיבה להתקנת האפליקציה.
appInstallTime

enum (ApplicationInstallTime)

זמן ההתקנה של האפליקציה, בהתאם למחזור החיים של האפליקציה.
appId

string

מזהה האפליקציה. כשמדובר באפליקציות מסוג PWA, זוהי כתובת ה-URL להתחלה, ולתוספים זהו מזהה התוסף.
appType

enum (TelemetryApplicationType)

סוג האפליקציה.

ApplicationInstallSource

מתאר את מקור ההתקנה של האפליקציה.

טיפוסים בני מנייה (enums)
APPLICATION_INSTALL_SOURCE_UNSPECIFIED מקור התקנת האפליקציה לא ידוע.
APPLICATION_INSTALL_SOURCE_SYSTEM האפליקציה מותקנת כחלק מ-Chrome OS.
APPLICATION_INSTALL_SOURCE_SYNC מקור התקנת האפליקציה הוא סנכרון.
APPLICATION_INSTALL_SOURCE_PLAY_STORE מקור התקנת האפליקציה הוא חנות Play.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE מקור התקנת האפליקציה הוא חנות האינטרנט של Chrome.
APPLICATION_INSTALL_SOURCE_BROWSER מקור התקנת האפליקציה הוא דפדפן.

ApplicationInstallReason

תיאור הסיבה להתקנת האפליקציה.

טיפוסים בני מנייה (enums)
APPLICATION_INSTALL_REASON_UNSPECIFIED הסיבה להתקנת האפליקציה לא ידועה.
APPLICATION_INSTALL_REASON_SYSTEM אפליקציה שמותקנת במערכת ונחשבת לחלק ממערכת ההפעלה.
APPLICATION_INSTALL_REASON_POLICY האפליקציה הותקנה על ידי המדיניות.
APPLICATION_INSTALL_REASON_OEM האפליקציה הותקנה על ידי יצרן ציוד מקורי (OEM).
APPLICATION_INSTALL_REASON_DEFAULT אפליקציה שמותקנת כברירת מחדל, אבל לא נחשבת לאפליקציית מערכת.
APPLICATION_INSTALL_REASON_SYNC האפליקציה הותקנה באמצעות סנכרון.
APPLICATION_INSTALL_REASON_USER האפליקציה הותקנה לפי פעולת המשתמש.
APPLICATION_INSTALL_REASON_SUB_APP האפליקציה שמותקנת באפליקציה bt SubApp API.
APPLICATION_INSTALL_REASON_KIOSK האפליקציה הותקנה על ידי "קיוסק" ב-Chrome OS.
APPLICATION_INSTALL_REASON_COMMAND_LINE האפליקציה הותקנה באמצעות ארגומנט של שורת פקודה.

ApplicationInstallTime

מתאר את זמן ההתקנה של האפליקציה בהתאם למחזור החיים של האפליקציה.

טיפוסים בני מנייה (enums)
APPLICATION_INSTALL_TIME_UNSPECIFIED זמן התקנת האפליקציה לא ידוע.
APPLICATION_INSTALL_TIME_INIT התקנת האפליקציה מאותחלת.
APPLICATION_INSTALL_TIME_RUNNING התקנת האפליקציה פועלת כרגע.

TelemetryAppUninstallEvent

נתונים לגבי התקנות של אפליקציות.

ייצוג JSON 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
שדות
appUninstallSource

enum (ApplicationUninstallSource)

מקור הסרת האפליקציה.
appId

string

מזהה האפליקציה. כשמדובר באפליקציות מסוג PWA, זוהי כתובת ה-URL להתחלה, ולתוספים זהו מזהה התוסף.
appType

enum (TelemetryApplicationType)

סוג האפליקציה.

ApplicationUninstallSource

מתאר את המקור להסרת ההתקנה של האפליקציה.

טיפוסים בני מנייה (enums)
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED מקור הסרת ההתקנה של האפליקציה לא ידוע.
APPLICATION_UNINSTALL_SOURCE_APP_LIST האפליקציה הוסרה מרשימת האפליקציות (מרכז האפליקציות).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT האפליקציה הוסרה מהדף 'ניהול אפליקציות'.
APPLICATION_UNINSTALL_SOURCE_SHELF האפליקציה הוסרה מהמדף.
APPLICATION_UNINSTALL_SOURCE_MIGRATION האפליקציה הוסרה בעקבות העברת האפליקציה.

TelemetryAppLaunchEvent

נתונים על הפעלת אפליקציות.

ייצוג JSON 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
שדות
appLaunchSource

enum (ApplicationLaunchSource)

מקור השקת האפליקציה.
appId

string

מזהה האפליקציה. כשמדובר באפליקציות מסוג PWA, זוהי כתובת ה-URL להתחלה, ולתוספים זהו מזהה התוסף.
appType

enum (TelemetryApplicationType)

סוג האפליקציה.

ApplicationLaunchSource

מתאר את מקור השקת האפליקציה.

טיפוסים בני מנייה (enums)
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED מקור השקת האפליקציה לא ידוע.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID האפליקציה מופעלת מרשת האפליקציות ולא מתיבת החיפוש.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU האפליקציה הושקה מרשת האפליקציות, מחוץ לתפריט ההקשר.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY האפליקציה הופעלה מתוצאות התלויות בשאילתה (סמלים גדולים יותר).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU האפליקציה הופעלה מתוצאות תלויות-שאילתה מחוץ לתפריט ההקשר.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION האפליקציה הושקה מהמלצות ללא שאילתה (סמלים קטנים יותר).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS האפליקציה הושקה מהקטע 'הגדרות של אמצעי בקרת הורים' ובקטע 'התראה לפי זמן לאפליקציה'.
APPLICATION_LAUNCH_SOURCE_SHELF האפליקציה הופעלה מהמדף.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER האפליקציה הופעלה ממנהל הקבצים
APPLICATION_LAUNCH_SOURCE_OMNIBOX האפליקציה הופעלה מהזנת כתובת URL בסרגל הכתובות בדפדפן.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL האפליקציה הופעלה משיחה פנימית ב-Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD האפליקציה הופעלה ממקשי קיצור לפתיחת האפליקציה.
APPLICATION_LAUNCH_SOURCE_OTHER_APP האפליקציה מופעלת בעקבות לחיצה על קישור באפליקציה אחרת או ב-WebUI.
APPLICATION_LAUNCH_SOURCE_MENU האפליקציה הופעלה מהתפריט.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION האפליקציה הופעלה דרך ההתראה שהותקנה.
APPLICATION_LAUNCH_SOURCE_TEST האפליקציה הופעלה מבדיקה.
APPLICATION_LAUNCH_SOURCE_ARC האפליקציה הושקה מ-Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET האפליקציה הושקה מ-Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION האפליקציה הושקה מההתראה לגבי נתוני הגרסה.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE האפליקציה הופעלה אחרי שחזור מלא.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU האפליקציה הופעלה מתפריט הקשר לבחירת טקסט חכמה.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION האפליקציה הופעלה מהתראה בכרטיסייה 'גילוי'.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API האפליקציה הושקה מ-Management API.
APPLICATION_LAUNCH_SOURCE_KIOSK האפליקציה הופעלה מקיוסק.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE האפליקציה הופעלה משורת הפקודה.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE האפליקציה הופעלה ממצב רקע.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE האפליקציה הושקה מדף הכרטיסייה החדשה.
APPLICATION_LAUNCH_SOURCE_INTENT_URL האפליקציה הופעלה מכתובת URL של Intent.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN האפליקציה הופעלה מהתחברות למערכת ההפעלה.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER האפליקציה הופעלה מ-handler של פרוטוקול.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER האפליקציה הופעלה מ-handler של כתובות URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN האפליקציה הופעלה ממרכז האפליקציות במסך הנעילה.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE האפליקציה הופעלה מדף הבית של האפליקציות (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING האפליקציה הושקה מהעברת תוכן לאפליקציה.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU האפליקציה הופעלה מתפריט הפרופיל של chrome://password-manager ב-WebUI להתקנה.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR האפליקציה הופעלה מהיומן של מגש המערכת.
APPLICATION_LAUNCH_SOURCE_INSTALLER האפליקציה הופעלה ממתקין המקור.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN ספרו בנפרד את ההשקות של אפליקציית העזרה הראשונה, כדי שנוכל להבין את מספר ההפעלות שהופעלו על ידי המשתמש.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR האפליקציה הושקה מסיור היכרות.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE האפליקציה הופעלה מחלונית המיקוד.

שיטות

list

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