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

string

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

object (TelemetryDeviceInfo)

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

object (TelemetryUserInfo)

פלט בלבד. מידע על המשתמש שמשויך לאירוע.
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".
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)

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

object (TelemetryAppInstallEvent)

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

object (TelemetryAppUninstallEvent)

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

object (TelemetryAppLaunchEvent)

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

object (TelemetryOsCrashEvent)

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

object (TelemetryExternalDisplayEvent)

פלט בלבד. ‫Payload לאירוע של חיבור או ניתוק של מסך חיצוני. המאפיין הזה מופיע רק אם הערך של eventType הוא EXTERNAL_DISPLAY_CONNECTED או EXTERNAL_DISPLAY_DISCONNECTED.

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

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

enum (TelemetryApplicationType)

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

ApplicationInstallSource

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

טיפוסים בני מנייה (enum)
APPLICATION_INSTALL_SOURCE_UNSPECIFIED מקור ההתקנה של האפליקציה לא ידוע.
APPLICATION_INSTALL_SOURCE_SYSTEM האפליקציה מותקנת כחלק מ-ChromeOS.
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 אפליקציה שמותקנת על ידי קיוסק ב-ChromeOS.
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 האפליקציה הופעלה אחרי לחיצה על קישור באפליקציה אחרת או בממשק משתמש באינטרנט.
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 handler.
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 שניתן להתקנה.
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 האפליקציה הופעלה מ-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.

TelemetryExternalDisplayEvent

מטען ייעודי (payload) של אירוע חיבור או ניתוק של מסך חיצוני.

ייצוג ב-JSON 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
שדות
externalDisplayData[]

object (TelemetryExternalDisplayData)

רשימה של מסכים חיצוניים שהיו מחוברים או מנותקים.

TelemetryExternalDisplayData

נתונים של מסך חיצוני.

ייצוג ב-JSON 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
שדות
displayName

string

השם המוצג.
resolutionHorizontal

integer

הרזולוציה האופקית.
resolutionVertical

integer

הרזולוציה האנכית.
refreshRate

string (int64 format)

קצב הרענון.
serialNumber

integer

המספר הסידורי.
edidVersion

string

גרסת ה-EDID.

Methods

list

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