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)
  }
}
ช่อง
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 เท่านั้น

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 ของความแรงสัญญาณ

วิธีการ

list

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