Method: customers.telemetry.events.list

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

คำขอ HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ รหัสลูกค้าหรือ "my_customer" เพื่อใช้ลูกค้าที่เชื่อมโยงกับบัญชีที่ส่งคำขอ

พารามิเตอร์การค้นหา

พารามิเตอร์
filter

string

ไม่บังคับ รวมเฉพาะทรัพยากรที่ตรงกับตัวกรองเท่านั้น แม้ว่าปัจจุบันพารามิเตอร์นี้จะเป็นแบบไม่บังคับ แต่ในอนาคตจะบังคับให้ใช้พารามิเตอร์นี้ โปรดระบุเหตุการณ์อย่างน้อย 1 ประเภท

ช่องตัวกรองที่รองรับ

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • การประทับเวลา
  • eventType
ตัวกรอง "การประทับเวลา" ยอมรับรูปแบบมิลลิวินาทีของ Unix Epoch หรือรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก รูปแบบทั้ง 2 รูปแบบควรอยู่ในเครื่องหมายคำพูดคู่ธรรมดา ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823"
readMask

string (FieldMask format)

ต้องระบุ อ่านมาสก์เพื่อระบุช่องที่จะแสดง แม้ว่าปัจจุบันจำเป็นต้องกรอกข้อมูลนี้ แต่ช่องนี้จะกลายเป็นช่องที่ไม่บังคับ และจำเป็นต้องมีพารามิเตอร์ตัวกรองที่มีประเภทเหตุการณ์

เส้นทาง readMask ที่รองรับมีดังนี้

  • อุปกรณ์
  • ผู้ใช้
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstallEvent
  • appUninstallEvent
  • appLaunchEvent
  • osCrashEvent

ซึ่งเป็นรายการชื่อฟิลด์ที่สมบูรณ์ในตัวเองที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
pageSize

integer

ไม่บังคับ จำนวนผลลัพธ์สูงสุดที่จะแสดง ค่าเริ่มต้นคือ 100 ค่าสูงสุดคือ 1,000
pageToken

string

ไม่บังคับ โทเค็นที่จะระบุหน้าถัดไปในรายการ

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "telemetryEvents": [
    {
      object (TelemetryEvent)
    }
  ],
  "nextPageToken": string
}
ช่อง
telemetryEvents[]

object (TelemetryEvent)

เหตุการณ์การส่งข้อมูลทางไกลที่แสดงในการตอบกลับ
nextPageToken

string

โทเค็นที่จะระบุหน้าถัดไปในรายการ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/chrome.management.telemetry.readonly