Method: chromeosdevices.list

เรียกข้อมูลรายการอุปกรณ์ ChromeOS ที่ใส่เลขหน้าภายในบัญชี

คำขอ 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

สตริงการค้นหาในรูปแบบที่ระบุไว้ใน https://developers.google.com/admin-sdk/directory/v1/list-query-operators

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)

รายการออบเจ็กต์อุปกรณ์ ChromeOS

nextPageToken

string

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

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

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

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

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

สั่งโดย

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

การฉายภาพ

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

Enum
BASIC รวมเฉพาะช่องข้อมูลเมตาพื้นฐาน (เช่น deviceId,SerialNumber สถานะ และผู้ใช้)
FULL รวมช่องข้อมูลเมตาทั้งหมด

SortOrder

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

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