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 แอปพลิเคชันติดตั้งโดย 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 เปิดแอปพลิเคชันจากเมนูโปรไฟล์ของ 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 เปิดแอปพลิเคชันจากแผงโฟกัสแล้ว

วิธีการ

list

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