Method: chromeosdevices.list

ดึงข้อมูลรายการอุปกรณ์ Chrome OS ที่แบ่งหน้าภายในบัญชี

คำขอ HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

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

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

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

string

รหัสที่ไม่ซ้ำสำหรับบัญชี Google Workspace ของลูกค้า ในฐานะผู้ดูแลบัญชี คุณยังใช้ชื่อแทน my_customer เพื่อแสดง customerId ของบัญชีได้ด้วย ระบบจะแสดงผล customerId เป็นส่วนหนึ่งของแหล่งข้อมูลผู้ใช้ด้วย

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

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

integer

จำนวนผลลัพธ์สูงสุดที่จะแสดง ค่าต้องไม่เกิน 300
orderBy

enum (OrderBy)

พร็อพเพอร์ตี้อุปกรณ์ที่จะใช้ในการจัดเรียงผลลัพธ์
orgUnitPath

string

เส้นทางแบบเต็มของหน่วยขององค์กร (ไม่รวม / ที่นำหน้า) หรือรหัสที่ไม่ซ้ำกันของหน่วยขององค์กร
pageToken

string

ระบบจะใช้พารามิเตอร์การค้นหา pageToken ในการขอหน้าถัดไปของผลการค้นหา พารามิเตอร์การค้นหา pageToken ของคำขอติดตามคือ nextPageToken จากการตอบกลับก่อนหน้าของคุณ
projection

enum (Projection)

กำหนดว่าการตอบกลับจะมีรายการพร็อพเพอร์ตี้ทั้งหมดหรือมีเพียงชุดย่อย
query

string

สตริงการค้นหาในรูปแบบที่ระบุไว้ในโอเปอเรเตอร์การค้นหาของ chromeosdevices.list
sortOrder

enum (SortOrder)

เลือกว่าจะแสดงผลลัพธ์ตามลำดับจากน้อยไปมากหรือมากไปน้อย ต้องใช้กับพารามิเตอร์ orderBy
includeChildOrgunits

boolean

ส่งคืนอุปกรณ์จากหน่วยขององค์กรย่อยทั้งหมด รวมถึงหน่วยขององค์กรที่ระบุ หากตั้งค่าเป็น "จริง" ต้องระบุ "orgUnitPath"

เนื้อความของคำขอ

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

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

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

การแสดง JSON 
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
ช่อง
kind

string

ประเภทของทรัพยากรนี้
etag

string

ETag ของทรัพยากร
chromeosdevices[]

object (ChromeOsDevice)

รายการออบเจ็กต์อุปกรณ์ Chrome OS
nextPageToken

string

โทเค็นที่ใช้เพื่อเข้าถึงหน้าถัดไปของผลลัพธ์นี้ หากต้องการเข้าถึงหน้าถัดไป ให้ใช้ค่าของโทเค็นนี้ในสตริงการค้นหา pageToken ของคำขอนี้

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

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์

OrderBy

Enum
ANNOTATED_LOCATION ตำแหน่งอุปกรณ์ Chrome ตามที่ผู้ดูแลระบบระบุ
ANNOTATED_USER ผู้ใช้ Chromebook ตามที่ผู้ดูแลระบบใส่คำอธิบายประกอบ
LAST_SYNC วันที่และเวลาที่อุปกรณ์ Chrome ทำการซิงค์กับการตั้งค่านโยบายในคอนโซลผู้ดูแลระบบครั้งล่าสุด
NOTES หมายเหตุของอุปกรณ์ Chrome ตามที่ผู้ดูแลระบบใส่คำอธิบายประกอบ
SERIAL_NUMBER หมายเลขซีเรียลของอุปกรณ์ Chrome ที่ป้อนเมื่อเปิดใช้อุปกรณ์
STATUS สถานะอุปกรณ์ Chrome ดูข้อมูลเพิ่มเติมได้ที่ <a chromeosdevices

การฉายภาพ

ประเภทการฉายที่จะแสดงสำหรับอุปกรณ์

Enum
BASIC รวมเฉพาะฟิลด์ข้อมูลเมตาพื้นฐาน (เช่น deviceId, serialNumber, status และ user)
FULL รวมช่องข้อมูลเมตาทั้งหมด

SortOrder

ลำดับการจัดเรียงที่ควรใช้กับรายการอุปกรณ์

Enum
ASCENDING เรียงลำดับจากน้อยไปมาก
DESCENDING เรียงลำดับจากมากไปน้อย