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)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  }
}
שדות
name

string

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

object (TelemetryDeviceInfo)

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

object (TelemetryUserInfo)

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

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
eventType

enum (EventType)

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

object (TelemetryAudioSevereUnderrunEvent)

פלט בלבד. המטען הייעודי של אירוע של מחסור חמור בזמן אודיו. השדה מופיע רק כשהערך בשדה eventType הוא AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

פלט בלבד. המטען הייעודי של האירוע 'ציוד היקפי 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)

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

object (TelemetryNetworkConnectionStateChangeEvent)

פלט בלבד. עומס שימושי של אירוע שינוי מצב החיבור ל-VPN. האפשרות הזו מוצגת רק כש-eventType הוא VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

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

object (TelemetryAppUninstallEvent)

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

object (TelemetryAppLaunchEvent)

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

object (TelemetryOsCrashEvent)

פלט בלבד. המטען הייעודי של אירוע קריסה במערכת ההפעלה. האפשרות הזו מוצגת רק כש-eventType הוא OS_CRASH.

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

TelemetryUsbPeripheralsEvent מופעל: התקני USB נוספים או מוסרים.

  • נדרשת הרשאה מפורטת: 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

מזהה האפליקציה. ב-PWAs, זהו מזהה ההתחלה, ובתוספים זהו מזהה התוסף.
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 אפליקציה שהותקנה באמצעות קריאה ל-API של SubApp.
APPLICATION_INSTALL_REASON_KIOSK אפליקציה שהותקנה על ידי 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

מזהה האפליקציה. ב-PWAs, זהו מזהה ההתחלה, ובתוספים זהו מזהה התוסף.
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

מזהה האפליקציה. ב-PWAs, זהו מזהה ההתחלה, ובתוספים זהו מזהה התוסף.
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 אפליקציה שהושקה בלחיצה על קישור באפליקציה אחרת או בממשק משתמש אינטרנטי.
APPLICATION_LAUNCH_SOURCE_MENU האפליקציה מופעלת מהתפריט.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION האפליקציה הופעל מההתראה המותקנת.
APPLICATION_LAUNCH_SOURCE_TEST אפליקציה שהופעל ממנה בדיקה.
APPLICATION_LAUNCH_SOURCE_ARC אפליקציה שהופעלה מ-Arc.
APPLICATION_LAUNCH_SOURCE_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 של כוונה.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN האפליקציה הופעל מ-OS Login.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER אפליקציה שהופעל ממנה ה-handler לפרוטוקולים.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER אפליקציה שהופעל ממנהל כתובות URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN אפליקציה שהופעל מרכז האפליקציות של מסך הנעילה.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE אפליקציה שהופעלה מדף הבית של האפליקציה (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING אפליקציה שהופעל על ידי העברת תוכן לאפליקציה.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU האפליקציה מופעלת מתפריט הפרופיל של ממשק המשתמש במחשב (WUI) הניתן להתקנה בכתובת chrome://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.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING אפליקציה שהופעל מתיעוד ניווט.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API אפליקציה שהושקה מ-Web Install API.

TelemetryOsCrashEvent

נתוני קריסות של מערכת ההפעלה.

ייצוג ב-JSON 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
שדות
crashType

enum (CrashType)

סוג הקריסה.
sessionType

enum (SessionType)

סוג הסשן.
crashId

string

מזהה תאונה.

CrashType

תיאור של סוג ההתרסקות.

טיפוסים בני מנייה (enum)
CRASH_TYPE_UNSPECIFIED סוג ההתרסקות לא ידוע.
CRASH_TYPE_KERNEL קריסה בליבה.
CRASH_TYPE_EMBEDDED_CONTROLLER קריסה של בקר מוטמע.

SessionType

תיאור של סוג הסשן.

טיפוסים בני מנייה (enum)
SESSION_TYPE_UNSPECIFIED סוג הסשן לא ידוע.
SESSION_TYPE_SIGNED_IN_USER משתמש שמחובר לחשבון.
SESSION_TYPE_KIOSK קיוסק.
SESSION_TYPE_MANAGED_GUEST גלישה מנוהלת כאורח.
SESSION_TYPE_ACTIVE_DIRECTORY סשן Active Directory.

Methods

list

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