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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 )

Output only. Payload for audio severe underrun event. Present only when the eventType field is AUDIO_SEVERE_UNDERRUN .

usbPeripheralsEvent

object ( TelemetryUsbPeripheralsEvent )

فقط خروجی. بار مفید برای رویداد لوازم جانبی USB. فقط زمانی نمایش داده می‌شود که فیلد eventType برابر با USB_ADDED یا USB_REMOVED باشد.

networkStateChangeEvent

object ( TelemetryNetworkConnectionStateChangeEvent )

فقط خروجی. بار مفید برای رویداد تغییر وضعیت اتصال شبکه. فقط زمانی ارائه می‌شود که eventType NETWORK_STATE_CHANGE باشد.

httpsLatencyChangeEvent

object ( TelemetryHttpsLatencyChangeEvent )

فقط خروجی. بار مفید برای رویداد تغییر تأخیر HTTPS. فقط زمانی ارائه می‌شود که eventType NETWORK_HTTPS_LATENCY_CHANGE باشد.

wifiSignalStrengthEvent

object ( TelemetryNetworkSignalStrengthEvent )

فقط خروجی. بار مفید برای رویدادهای قدرت سیگنال WiFi. فقط زمانی ارائه می‌شود که 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 )

فقط خروجی. بار مفید برای رویداد راه‌اندازی برنامه. فقط زمانی ارائه می‌شود که eventType APP_LAUNCHED باشد.

osCrashEvent

object ( TelemetryOsCrashEvent )

فقط خروجی. بار مفید برای رویداد خرابی سیستم عامل. فقط زمانی ارائه می‌شود که eventType OS_CRASH باشد.

externalDisplaysEvent

object ( TelemetryExternalDisplayEvent )

فقط خروجی. بار مفید برای رویداد اتصال/قطع اتصال نمایشگر خارجی. فقط زمانی ارائه می‌شود که eventType EXTERNAL_DISPLAY_CONNECTED یا EXTERNAL_DISPLAY_DISCONNECTED باشد.

اطلاعات دستگاه تله‌متری

اطلاعات مربوط به دستگاهی که با داده‌های تله‌متری مرتبط است.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_DEVICE
نمایش JSON 
{
  "deviceId": string,
  "orgUnitId": string
}
فیلدها
deviceId

string

فقط خروجی. شناسه API دایرکتوری منحصر به فرد دستگاه. این مقدار همان شناسه API دایرکتوری کنسول مدیریت در تب دستگاه‌های ChromeOS است.

orgUnitId

string

فقط خروجی. شناسه واحد سازمانی دستگاه.

اطلاعات کاربری تله‌متری

اطلاعات مربوط به یک کاربر مرتبط با داده‌های تله‌متری.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_USER
نمایش JSON 
{
  "email": string,
  "orgUnitId": string
}
فیلدها
email

string

فقط خروجی. ایمیل کاربر.

orgUnitId

string

فقط خروجی. شناسه واحد سازمانی کاربر.

TelemetryAudioSevereUnderrunEvent

این نوع هیچ فیلدی ندارد.

TelemetryAudioSevereUnderrunEvent زمانی رخ می‌دهد که یک دستگاه صوتی بیش از ۵ ثانیه بافر داده نداشته باشد.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_AUDIO_REPORT

تله‌متری، لوازم جانبی USB، رویداد

TelemetryUsbPeripheralsEvent باعث می‌شود دستگاه‌های USB اضافه یا حذف شوند.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_PERIPHERALS_REPORT
نمایش JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
فیلدها
usbPeripheralReport[]

object ( UsbPeripheralReport )

فهرست دستگاه‌های USB که اضافه یا حذف شده‌اند.

رویداد تغییر وضعیت اتصال شبکه از راه دور

TelemetryNetworkConnectionStateChangeEvent در صورت تغییر وضعیت اتصال شبکه فعال می‌شود.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایش JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
فیلدها
guid

string

شناسه منحصر به فرد شبکه.

connectionState

enum ( NetworkConnectionState )

وضعیت اتصال فعلی شبکه.

تله‌متریHTTPSLatencyChangeEvent

روال تأخیر Https به صورت دوره‌ای اجرا می‌شود و اگر مشکل تأخیر تشخیص داده شود یا دستگاه از مشکل تأخیر بهبود یابد، TelemetryHttpsLatencyChangeEvent فعال می‌شود.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایش JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
فیلدها
httpsLatencyRoutineData

object ( HttpsLatencyRoutineData )

داده‌های روال تأخیر HTTPS که باعث ایجاد رویداد شده‌اند.

httpsLatencyState

enum ( HttpsLatencyState )

وضعیت فعلی تأخیر HTTPS.

وضعیت تأخیر Https

وضعیت تأخیر HTTPS.

انوم‌ها
HTTPS_LATENCY_STATE_UNSPECIFIED وضعیت تأخیر HTTPS مشخص نشده است.
RECOVERY تأخیر HTTPS از یک مشکل بازیابی شد.
PROBLEM مشکل تأخیر HTTPS.

تله‌متریشبکهقدرت سیگنالرویداد

TelemetryNetworkSignalStrengthEvent در رویدادهای مربوط به قدرت سیگنال WiFi فعال می‌شود.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایش JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
فیلدها
guid

string

شناسه منحصر به فرد شبکه.

signalStrengthDbm

integer

مقدار RSSI قدرت سیگنال.

رویداد نصب برنامه از راه دور

داده‌های نصب برنامه.

نمایش 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ها این آدرس شروع و برای افزونه‌ها این شناسه افزونه است.

appType

enum ( TelemetryApplicationType )

نوع برنامه.

منبع نصب برنامه

منبع نصب برنامه را شرح می‌دهد.

انوم‌ها
APPLICATION_INSTALL_SOURCE_UNSPECIFIED منبع نصب برنامه ناشناخته است.
APPLICATION_INSTALL_SOURCE_SYSTEM برنامه به عنوان بخشی از سیستم عامل کروم نصب شده است.
APPLICATION_INSTALL_SOURCE_SYNC منبع نصب برنامه همگام‌سازی شده است.
APPLICATION_INSTALL_SOURCE_PLAY_STORE منبع نصب برنامه، فروشگاه Play است.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE منبع نصب برنامه، فروشگاه وب کروم است.
APPLICATION_INSTALL_SOURCE_BROWSER منبع نصب برنامه یک مرورگر است.

دلیل نصب برنامه

دلیل نصب برنامه را شرح می‌دهد.

انوم‌ها
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 برنامه از طریق فراخوانی SubApp API نصب شد.
APPLICATION_INSTALL_REASON_KIOSK برنامه توسط کیوسک روی سیستم عامل کروم نصب شده است.
APPLICATION_INSTALL_REASON_COMMAND_LINE برنامه توسط آرگومان خط فرمان نصب می‌شود.

زمان نصب برنامه

زمان نصب برنامه را بسته به چرخه حیات برنامه توصیف می‌کند.

انوم‌ها
APPLICATION_INSTALL_TIME_UNSPECIFIED زمان نصب برنامه مشخص نیست
APPLICATION_INSTALL_TIME_INIT نصب برنامه مقداردهی اولیه شده است.
APPLICATION_INSTALL_TIME_RUNNING نصب برنامه در حال حاضر در حال اجرا است.

رویداد حذف نصب برنامه از راه دور

داده‌های حذف برنامه.

نمایش JSON 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
فیلدها
appUninstallSource

enum ( ApplicationUninstallSource )

منبع حذف برنامه.

appId

string

شناسه برنامه. برای PWAها این آدرس شروع و برای افزونه‌ها این شناسه افزونه است.

appType

enum ( TelemetryApplicationType )

نوع برنامه.

منبع حذف برنامه

منبع حذف برنامه را شرح می‌دهد.

انوم‌ها
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED منبع حذف برنامه ناشناخته است.
APPLICATION_UNINSTALL_SOURCE_APP_LIST برنامه از فهرست برنامه‌ها (لانچر) حذف نصب شد.
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT برنامه از صفحه مدیریت برنامه حذف نصب شد.
APPLICATION_UNINSTALL_SOURCE_SHELF برنامه از قفسه حذف نصب شد.
APPLICATION_UNINSTALL_SOURCE_MIGRATION برنامه با انتقال برنامه حذف نصب شد.

رویداد TelemetryAppLaunch

داده‌های راه‌اندازی برنامه.

نمایش JSON 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
فیلدها
appLaunchSource

enum ( ApplicationLaunchSource )

منبع راه‌اندازی برنامه.

appId

string

شناسه برنامه. برای PWAها این آدرس شروع و برای افزونه‌ها این شناسه افزونه است.

appType

enum ( TelemetryApplicationType )

نوع برنامه.

منبع اجرای برنامه

منبع اجرای برنامه را شرح می‌دهد.

انوم‌ها
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 در Omnibox مرورگر اجرا می‌شود.
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 برنامه از 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 برنامه از طریق اعلان تب Discover اجرا شد.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API برنامه از 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 URL) اجرا می‌شود.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN برنامه از طریق ورود به سیستم عامل اجرا شد.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER برنامه از کنترل‌کننده پروتکل اجرا شد.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER برنامه از طریق کنترل کننده URL اجرا شد.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN برنامه از لانچر برنامه قفل صفحه اجرا شد.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE برنامه از صفحه اصلی برنامه ( chrome://apps ) اجرا شد.
APPLICATION_LAUNCH_SOURCE_REPARENTING برنامه از انتقال محتوا به یک برنامه کاربردی (app) راه‌اندازی شد.
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 برنامه از پنل فوکوس اجرا شد.
APPLICATION_LAUNCH_SOURCE_SPARKY برنامه از ویژگی آزمایشی Sparky راه‌اندازی شد.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING برنامه از ضبط ناوبری اجرا شد.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API برنامه از طریق رابط برنامه‌نویسی کاربردی نصب وب (Web Install API) اجرا می‌شود.

رویداد تله‌متری‌اُس‌کِرَش

داده‌های خرابی سیستم عامل.

نمایش JSON 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
فیلدها
crashType

enum ( CrashType )

نوع تصادف.

sessionType

enum ( SessionType )

نوع جلسه.

crashId

string

شناسهٔ تصادف.

نوع تصادف

نوع تصادف را توصیف می‌کند.

انوم‌ها
CRASH_TYPE_UNSPECIFIED نوع تصادف نامشخص.
CRASH_TYPE_KERNEL خرابی هسته.
CRASH_TYPE_EMBEDDED_CONTROLLER خرابی کنترلر تعبیه‌شده.

نوع جلسه

نوع جلسه را توصیف می‌کند.

انوم‌ها
SESSION_TYPE_UNSPECIFIED نوع جلسه نامشخص است.
SESSION_TYPE_SIGNED_IN_USER کاربر وارد سیستم شده است.
SESSION_TYPE_KIOSK کیوسک
SESSION_TYPE_MANAGED_GUEST جلسه مهمان مدیریت شده.
SESSION_TYPE_ACTIVE_DIRECTORY جلسه دایرکتوری فعال.

رویداد نمایش خارجی تله‌متری

بار رویداد اتصال/قطع اتصال نمایشگر خارجی.

نمایش JSON 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
فیلدها
externalDisplayData[]

object ( 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.

روش‌ها

list

 رویدادهای تله‌متری را فهرست کنید.
،

منبع: 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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 )

فقط خروجی. بار مفید برای رویداد تغییر وضعیت اتصال شبکه. فقط زمانی ارائه می‌شود که eventType NETWORK_STATE_CHANGE باشد.

httpsLatencyChangeEvent

object ( TelemetryHttpsLatencyChangeEvent )

فقط خروجی. بار مفید برای رویداد تغییر تأخیر HTTPS. فقط زمانی ارائه می‌شود که eventType NETWORK_HTTPS_LATENCY_CHANGE باشد.

wifiSignalStrengthEvent

object ( TelemetryNetworkSignalStrengthEvent )

فقط خروجی. بار مفید برای رویدادهای قدرت سیگنال WiFi. فقط زمانی ارائه می‌شود که 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 )

فقط خروجی. بار مفید برای رویداد راه‌اندازی برنامه. فقط زمانی ارائه می‌شود که eventType APP_LAUNCHED باشد.

osCrashEvent

object ( TelemetryOsCrashEvent )

فقط خروجی. بار مفید برای رویداد خرابی سیستم عامل. فقط زمانی ارائه می‌شود که eventType OS_CRASH باشد.

externalDisplaysEvent

object ( TelemetryExternalDisplayEvent )

فقط خروجی. بار مفید برای رویداد اتصال/قطع اتصال نمایشگر خارجی. فقط زمانی ارائه می‌شود که eventType EXTERNAL_DISPLAY_CONNECTED یا EXTERNAL_DISPLAY_DISCONNECTED باشد.

اطلاعات دستگاه تله‌متری

اطلاعات مربوط به دستگاهی که با داده‌های تله‌متری مرتبط است.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_DEVICE
نمایش JSON 
{
  "deviceId": string,
  "orgUnitId": string
}
فیلدها
deviceId

string

فقط خروجی. شناسه API دایرکتوری منحصر به فرد دستگاه. این مقدار همان شناسه API دایرکتوری کنسول مدیریت در تب دستگاه‌های ChromeOS است.

orgUnitId

string

فقط خروجی. شناسه واحد سازمانی دستگاه.

اطلاعات کاربری تله‌متری

اطلاعات مربوط به یک کاربر مرتبط با داده‌های تله‌متری.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_USER
نمایش JSON 
{
  "email": string,
  "orgUnitId": string
}
فیلدها
email

string

فقط خروجی. ایمیل کاربر.

orgUnitId

string

فقط خروجی. شناسه واحد سازمانی کاربر.

TelemetryAudioSevereUnderrunEvent

این نوع هیچ فیلدی ندارد.

TelemetryAudioSevereUnderrunEvent زمانی رخ می‌دهد که یک دستگاه صوتی بیش از ۵ ثانیه بافر داده نداشته باشد.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_AUDIO_REPORT

تله‌متری، لوازم جانبی USB، رویداد

TelemetryUsbPeripheralsEvent باعث می‌شود دستگاه‌های USB اضافه یا حذف شوند.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_PERIPHERALS_REPORT
نمایش JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
فیلدها
usbPeripheralReport[]

object ( UsbPeripheralReport )

فهرست دستگاه‌های USB که اضافه یا حذف شده‌اند.

رویداد تغییر وضعیت اتصال شبکه از راه دور

TelemetryNetworkConnectionStateChangeEvent در صورت تغییر وضعیت اتصال شبکه فعال می‌شود.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایش JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
فیلدها
guid

string

شناسه منحصر به فرد شبکه.

connectionState

enum ( NetworkConnectionState )

وضعیت اتصال فعلی شبکه.

تله‌متریHTTPSLatencyChangeEvent

روال تأخیر Https به صورت دوره‌ای اجرا می‌شود و اگر مشکل تأخیر تشخیص داده شود یا دستگاه از مشکل تأخیر بهبود یابد، TelemetryHttpsLatencyChangeEvent فعال می‌شود.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایش JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
فیلدها
httpsLatencyRoutineData

object ( HttpsLatencyRoutineData )

داده‌های روال تأخیر HTTPS که باعث ایجاد رویداد شده‌اند.

httpsLatencyState

enum ( HttpsLatencyState )

وضعیت فعلی تأخیر HTTPS.

وضعیت تأخیر Https

وضعیت تأخیر HTTPS.

انوم‌ها
HTTPS_LATENCY_STATE_UNSPECIFIED وضعیت تأخیر HTTPS مشخص نشده است.
RECOVERY تأخیر HTTPS از یک مشکل بازیابی شد.
PROBLEM مشکل تأخیر HTTPS.

تله‌متریشبکهقدرت سیگنالرویداد

TelemetryNetworkSignalStrengthEvent در رویدادهای مربوط به قدرت سیگنال WiFi فعال می‌شود.

  • مجوز جزئی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایش JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
فیلدها
guid

string

شناسه منحصر به فرد شبکه.

signalStrengthDbm

integer

مقدار RSSI قدرت سیگنال.

رویداد نصب برنامه از راه دور

داده‌های نصب برنامه.

نمایش 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ها این آدرس شروع و برای افزونه‌ها این شناسه افزونه است.

appType

enum ( TelemetryApplicationType )

نوع برنامه.

منبع نصب برنامه

منبع نصب برنامه را شرح می‌دهد.

انوم‌ها
APPLICATION_INSTALL_SOURCE_UNSPECIFIED منبع نصب برنامه ناشناخته است.
APPLICATION_INSTALL_SOURCE_SYSTEM برنامه به عنوان بخشی از سیستم عامل کروم نصب شده است.
APPLICATION_INSTALL_SOURCE_SYNC منبع نصب برنامه همگام‌سازی شده است.
APPLICATION_INSTALL_SOURCE_PLAY_STORE منبع نصب برنامه، فروشگاه Play است.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE منبع نصب برنامه، فروشگاه وب کروم است.
APPLICATION_INSTALL_SOURCE_BROWSER منبع نصب برنامه یک مرورگر است.

دلیل نصب برنامه

دلیل نصب برنامه را شرح می‌دهد.

انوم‌ها
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 برنامه از طریق فراخوانی SubApp API نصب شد.
APPLICATION_INSTALL_REASON_KIOSK برنامه توسط کیوسک روی سیستم عامل کروم نصب شده است.
APPLICATION_INSTALL_REASON_COMMAND_LINE برنامه توسط آرگومان خط فرمان نصب می‌شود.

زمان نصب برنامه

زمان نصب برنامه را بسته به چرخه حیات برنامه توصیف می‌کند.

انوم‌ها
APPLICATION_INSTALL_TIME_UNSPECIFIED زمان نصب برنامه مشخص نیست
APPLICATION_INSTALL_TIME_INIT نصب برنامه مقداردهی اولیه شده است.
APPLICATION_INSTALL_TIME_RUNNING نصب برنامه در حال حاضر در حال اجرا است.

رویداد حذف نصب برنامه از راه دور

داده‌های حذف برنامه.

نمایش JSON 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
فیلدها
appUninstallSource

enum ( ApplicationUninstallSource )

منبع حذف برنامه.

appId

string

شناسه برنامه. برای PWAها این آدرس شروع و برای افزونه‌ها این شناسه افزونه است.

appType

enum ( TelemetryApplicationType )

نوع برنامه.

منبع حذف برنامه

منبع حذف برنامه را شرح می‌دهد.

انوم‌ها
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED منبع حذف برنامه ناشناخته است.
APPLICATION_UNINSTALL_SOURCE_APP_LIST برنامه از فهرست برنامه‌ها (لانچر) حذف نصب شد.
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT برنامه از صفحه مدیریت برنامه حذف نصب شد.
APPLICATION_UNINSTALL_SOURCE_SHELF برنامه از قفسه حذف نصب شد.
APPLICATION_UNINSTALL_SOURCE_MIGRATION برنامه با انتقال برنامه حذف نصب شد.

رویداد TelemetryAppLaunch

داده‌های راه‌اندازی برنامه.

نمایش JSON 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
فیلدها
appLaunchSource

enum ( ApplicationLaunchSource )

منبع راه‌اندازی برنامه.

appId

string

شناسه برنامه. برای PWAها این آدرس شروع و برای افزونه‌ها این شناسه افزونه است.

appType

enum ( TelemetryApplicationType )

نوع برنامه.

منبع اجرای برنامه

منبع اجرای برنامه را شرح می‌دهد.

انوم‌ها
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 در Omnibox مرورگر اجرا می‌شود.
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 برنامه از 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 برنامه از طریق اعلان تب Discover اجرا شد.
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API برنامه از 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 URL) اجرا می‌شود.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN برنامه از طریق ورود به سیستم عامل اجرا شد.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER برنامه از کنترل‌کننده پروتکل اجرا شد.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER برنامه از طریق کنترل کننده URL اجرا شد.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN برنامه از لانچر برنامه قفل صفحه اجرا شد.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE برنامه از صفحه اصلی برنامه ( chrome://apps ) اجرا شد.
APPLICATION_LAUNCH_SOURCE_REPARENTING برنامه از انتقال محتوا به یک برنامه کاربردی (app) راه‌اندازی شد.
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 برنامه از پنل فوکوس اجرا شد.
APPLICATION_LAUNCH_SOURCE_SPARKY برنامه از ویژگی آزمایشی Sparky راه‌اندازی شد.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING برنامه از ضبط ناوبری اجرا شد.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API برنامه از طریق رابط برنامه‌نویسی کاربردی نصب وب (Web Install API) اجرا می‌شود.

رویداد تله‌متری‌اُس‌کِرَش

داده‌های خرابی سیستم عامل.

نمایش JSON 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
فیلدها
crashType

enum ( CrashType )

نوع تصادف.

sessionType

enum ( SessionType )

نوع جلسه.

crashId

string

شناسهٔ تصادف.

نوع تصادف

نوع تصادف را توصیف می‌کند.

انوم‌ها
CRASH_TYPE_UNSPECIFIED نوع تصادف نامشخص.
CRASH_TYPE_KERNEL خرابی هسته.
CRASH_TYPE_EMBEDDED_CONTROLLER خرابی کنترلر تعبیه‌شده.

نوع جلسه

نوع جلسه را توصیف می‌کند.

انوم‌ها
SESSION_TYPE_UNSPECIFIED نوع جلسه نامشخص است.
SESSION_TYPE_SIGNED_IN_USER کاربر وارد سیستم شده است.
SESSION_TYPE_KIOSK کیوسک
SESSION_TYPE_MANAGED_GUEST جلسه مهمان مدیریت شده.
SESSION_TYPE_ACTIVE_DIRECTORY جلسه دایرکتوری فعال.

رویداد نمایش خارجی تله‌متری

بار رویداد اتصال/قطع اتصال نمایشگر خارجی.

نمایش JSON 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
فیلدها
externalDisplayData[]

object ( 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.

روش‌ها

list

 رویدادهای تله‌متری را فهرست کنید.