Method: customers.telemetry.devices.list

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

คำขอ HTTP

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

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

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

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

string

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

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

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

string

ไม่บังคับ รวมเฉพาะทรัพยากรที่ตรงกับตัวกรองเท่านั้น คำขอที่ไม่ได้ระบุ "reports_timestamp" จะมีค่าเริ่มต้นเป็นการส่งคืนรายงานล่าสุดเท่านั้น ระบุ "reports_timestamp>=0" เพื่อรับข้อมูลรายงานทั้งหมด

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

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

string (FieldMask format)

ต้องระบุ อ่านมาสก์เพื่อระบุช่องที่จะแสดง

เส้นทาง ReadMask ที่รองรับ ได้แก่

  • ชื่อ
  • orgUnitId
  • deviceId
  • serialNumber
  • cpuInfo
  • cpuStatusReport
  • memoryInfo
  • memoryStatusReport
  • networkInfo
  • networkDiagnosticsReport
  • networkStatusReport
  • osUpdateStatus
  • graphicsInfo
  • graphicsStatusReport
  • batteryInfo
  • batteryStatusReport
  • storageInfo
  • storageStatusReport
  • thunderboltInfo
  • audioStatusReport
  • bootPerformanceReport
  • heartbeatStatusReport
  • networkBandwidthReport
  • peripheralsReport
  • kioskAppStatusReport
  • appReport
  • runtimeCountersReport

ซึ่งเป็นรายการชื่อที่ตรงตามเกณฑ์ทั้งหมดของช่องที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
pageSize

integer

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

string

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

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

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

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

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

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

object (TelemetryDevice)

อุปกรณ์การวัดและส่งข้อมูลทางไกลที่แสดงผลในคำตอบ
nextPageToken

string

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

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

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

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