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" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

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)

เอาต์พุตเท่านั้น เพย์โหลดสำหรับเหตุการณ์ความแรงของสัญญาณ 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)

เอาต์พุตเท่านั้น เพย์โหลดสำหรับกิจกรรมการเปิดตัวแอป นำเสนอเมื่อ eventType คือ APP_LAUNCHED เท่านั้น

TelemetryDeviceInfo

ข้อมูลเกี่ยวกับอุปกรณ์ที่เชื่อมโยงกับข้อมูลการวัดและส่งข้อมูลทางไกล

  • ต้องมีสิทธิ์แบบละเอียด: TELEMETRY_API_DEVICE
การแสดง JSON
{
  "deviceId": string,
  "orgUnitId": string
}
ช่อง
deviceId

string

เอาต์พุตเท่านั้น รหัส API ไดเรกทอรีที่ไม่ซ้ำกันของอุปกรณ์ ค่านี้เหมือนกับรหัส Directory API ของคอนโซลผู้ดูแลระบบในแท็บอุปกรณ์ 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 Store
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 ถอนการติดตั้งแอปพลิเคชันจากรายการแอป (Launcher) แล้ว
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 เปิดแอปพลิเคชันจากเครื่องจัดการโปรโตคอล
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 เปิดใช้แอปพลิเคชันจากเมนูโปรไฟล์ของ WebUI ของ 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

เมธอด

list

แสดงรายการเหตุการณ์การส่งข้อมูลทางไกล