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 )

فقط خروجی اطلاعات مربوط به کاربر مرتبط با رویداد.

report Time

string ( Timestamp format)

مهر زمانی که نشان دهنده زمان گزارش رویداد است.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

event Type

enum ( EventType )

نوع رویداد رویداد جاری.

audio Severe Underrun Event

object ( TelemetryAudioSevereUnderrunEvent )

فقط خروجی بارگذاری برای رویداد افت شدید صوتی. تنها زمانی ارائه شود که قسمت eventType AUDIO_SEVERE_UNDERRUN باشد.

usb Peripherals Event

object ( TelemetryUsbPeripheralsEvent )

فقط خروجی رویداد Payload برای وسایل جانبی usb. تنها زمانی ارائه شود که قسمت eventType یا USB_ADDED یا USB_REMOVED باشد.

network State Change Event

object ( TelemetryNetworkConnectionStateChangeEvent )

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

https Latency Change Event

object ( TelemetryHttpsLatencyChangeEvent )

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

wifi Signal Strength Event

object ( TelemetryNetworkSignalStrengthEvent )

فقط خروجی بار برای رویدادهای قدرت سیگنال WiFi. تنها زمانی ارائه شود که eventType WIFI_SIGNAL_STRENGTH_LOW یا WIFI_SIGNAL_STRENGTH_RECOVERED باشد.

vpn Connection State Change Event

object ( TelemetryNetworkConnectionStateChangeEvent )

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

app Install Event

object ( TelemetryAppInstallEvent )

فقط خروجی Payload برای رویداد نصب برنامه. تنها زمانی ارائه شود که eventType APP_INSTALLED باشد.

app Uninstall Event

object ( TelemetryAppUninstallEvent )

فقط خروجی Payload برای رویداد حذف نصب برنامه. تنها زمانی ارائه شود که eventType APP_UNINSTALLED باشد.

app Launch Event

object ( TelemetryAppLaunchEvent )

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

TelemetryDeviceInfo

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

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

string

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

org Unit Id

string

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

TelemetryUserInfo

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

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

string

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

org Unit Id

string

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

TelemetryAudioSevereUnderrunEvent

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

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

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

رویداد TelemetryUsbPeripherals

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

  • مجوز کلی مورد نیاز: TELEMETRY_API_PERIPHERALS_REPORT
نمایندگی JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
فیلدها
usb Peripheral Report[]

object ( UsbPeripheralReport )

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

رویداد TelemetryNetworkConnectionStateChangeEvent

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

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

string

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

connection State

enum ( NetworkConnectionState )

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

TelemetryHttpsLatencyChangeEvent

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

  • مجوز کلی مورد نیاز: TELEMETRY_API_NETWORK_REPORT
نمایندگی JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
فیلدها
https Latency Routine Data

object ( HttpsLatencyRoutineData )

داده‌های روتین تأخیر HTTPS که رویداد را راه‌اندازی کرد.

https Latency State

enum ( HttpsLatencyState )

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

HttpsLatencyState

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

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

TelemetryNetworkSignalStrengthEvent

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

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

string

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

signal Strength Dbm

integer

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

TelemetryAppInstallEvent

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

نمایندگی JSON 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
فیلدها
app Install Source

enum ( ApplicationInstallSource )

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

app Install Reason

enum ( ApplicationInstallReason )

دلیل نصب اپلیکیشن

app Install Time

enum ( ApplicationInstallTime )

زمان نصب برنامه بسته به چرخه عمر برنامه.

app Id

string

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

app Type

enum ( TelemetryApplicationType )

نوع برنامه

ApplicationInstallSource

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

Enums
APPLICATION_INSTALL_SOURCE_UNSPECIFIED منبع نصب برنامه ناشناخته است.
APPLICATION_INSTALL_SOURCE_SYSTEM برنامه به عنوان بخشی از سیستم عامل Chrome نصب شده است.
APPLICATION_INSTALL_SOURCE_SYNC منبع نصب برنامه یک همگام سازی است.
APPLICATION_INSTALL_SOURCE_PLAY_STORE منبع نصب برنامه Play Store است.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE منبع نصب برنامه، فروشگاه وب کروم است.
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 برنامه نصب شده توسط Kiosk در سیستم عامل Chrome.
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)
}
فیلدها
app Uninstall Source

enum ( ApplicationUninstallSource )

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

app Id

string

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

app Type

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)
}
فیلدها
app Launch Source

enum ( ApplicationLaunchSource )

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

app Id

string

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

app Type

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 در Omnibox در مرورگر راه اندازی شد.
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 برنامه از مدیریت 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 برنامه از ورود به سیستم عامل راه اندازی شد.
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 برنامه از انتقال محتوا به یک برنامه راه اندازی شد.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU برنامه از منوی نمایه chrome://password-manager WebUI قابل نصب راه اندازی شد.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR برنامه از تقویم سینی سیستم راه اندازی شد.
APPLICATION_LAUNCH_SOURCE_INSTALLER برنامه از نصب کننده منبع راه اندازی شد.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN راه‌اندازی‌های برنامه Help اولین بار را جداگانه شمارش کنید تا بتوانیم تعداد راه‌اندازی‌های راه‌اندازی شده توسط کاربر را بفهمیم.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR برنامه از تور خوش آمد گویی راه اندازی شد.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE برنامه از پانل فوکوس راه اندازی شد.
APPLICATION_LAUNCH_SOURCE_SPARKY برنامه از ویژگی آزمایشی Sparky راه اندازی شد.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING برنامه از ضبط ناوبری راه اندازی شد.

روش ها

list

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