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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

object (TelemetryNetworkSignalStrengthEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

פלט בלבד. מטען ייעודי (payload) לאירוע שינוי מצב החיבור ל-VPN. הצגה רק כשהערך של 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.

טיפוסים בני מנייה (enum)
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

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

טיפוסים בני מנייה (enum)
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

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

טיפוסים בני מנייה (enum)
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

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

טיפוסים בני מנייה (enum)
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

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

טיפוסים בני מנייה (enum)
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

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

טיפוסים בני מנייה (enum)
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 האפליקציה הופעלה מתפריט הפרופיל ב-WebUIchrome://password-manager שניתן להתקנה.
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 האפליקציה הופעלה מחלונית המיקוד.
APPLICATION_LAUNCH_SOURCE_SPARKY האפליקציה הושקה מהתכונה הניסיונית Sparky.

שיטות

list

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