Method: chromeosdevices.action

ใช้ BatchChangeChromeOsDeviceStatus แทน ดำเนินการที่ส่งผลต่ออุปกรณ์ Chrome OS ซึ่งรวมถึงการยกเลิกการจัดสรร การปิดใช้ และการเปิดใช้อุปกรณ์อีกครั้ง

คำขอ HTTP

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action

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

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

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

string

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

string

รหัสที่ไม่ซ้ำกันของอุปกรณ์ ระบบจะแสดงผล resourceId ในการตอบสนองจากเมธอด chromeosdevices.list

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

เนื้อความของคำขอมีอินสแตนซ์ของ ChromeOsDeviceAction

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

หากสำเร็จ การตอบกลับจะเป็นการตอบกลับ HTTP ทั่วไปที่เมธอดกำหนดรูปแบบ

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

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

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

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

ChromeOsDeviceAction

ข้อมูลเกี่ยวกับการอัปเดตสถานะอุปกรณ์ Chrome OS

การแสดง JSON 
{
  "action": string,
  "deprovisionReason": string
}
ช่อง
action

string

chromeosdevices.action ที่จะดำเนินการในอุปกรณ์ Chrome OS

ค่าที่ยอมรับมีดังนี้

  • deprovision: นำอุปกรณ์ออกจากการจัดการที่ไม่ได้ใช้งานแล้ว ขายต่อ หรือกำลังส่งเพื่อส่งคืน / ซ่อม ให้ใช้การยกเลิกการจัดสรรเพื่อยกเลิกการเชื่อมโยงอุปกรณ์จากการจัดการ
  • disable: หากเชื่อว่าอุปกรณ์ในองค์กรสูญหายหรือถูกขโมย คุณสามารถปิดใช้อุปกรณ์นั้นเพื่อไม่ให้คนอื่นใช้งานได้ เมื่อปิดใช้อุปกรณ์ ผู้ใช้ทุกคนจะเห็นหน้าจอเมื่อเปิดอุปกรณ์ Chrome ว่าอุปกรณ์ปิดใช้อยู่ พร้อมด้วยข้อมูลติดต่อที่คุณต้องการส่งคืนอุปกรณ์
  • reenable: เปิดใช้อุปกรณ์ที่ปิดใช้ไปแล้วอีกครั้งเมื่อพบอุปกรณ์ที่วางไว้ผิดที่หรือได้รับอุปกรณ์ที่สูญหายคืน นอกจากนี้ยังใช้ฟีเจอร์นี้ได้หากทำเครื่องหมายอุปกรณ์ Chrome เป็นปิดใช้โดยไม่ได้ตั้งใจ
  • pre_provisioned_disable: อุปกรณ์ที่จัดสรรไว้ล่วงหน้าซึ่งลงทะเบียนไม่ได้ ผู้ดูแลระบบสามารถเปิดใช้อุปกรณ์อีกครั้งเพื่อใช้การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มโดยเปลี่ยนสถานะเป็น "pre_provisioned_reenable" หมายเหตุ: จากสถานะนี้ คุณจะยกเลิกการจัดสรรอุปกรณ์ได้
  • pre_provisioned_reenable: อุปกรณ์ได้รับการจัดสรรล่วงหน้าโดย OEM อุปกรณ์ที่อยู่ในสถานะนี้มีสิทธิ์ใช้การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
deprovisionReason

string

ใช้เมื่อมีการยกเลิกการจัดสรรการดำเนินการเท่านั้น ต้องระบุข้อมูลในช่องนี้เมื่อมีการยกเลิกการจัดสรร

ค่าที่ยอมรับมีดังนี้

  • different_model_replacement: ใช้หากคุณกำลังอัปเกรดหรือเปลี่ยนอุปกรณ์ด้วยอุปกรณ์เดียวกันแต่เป็นรุ่นที่ใหม่กว่า
  • retiring_device: ใช้ในกรณีที่คุณขายต่อ บริจาค หรือนำอุปกรณ์ออกจากการใช้งานอย่างถาวร
  • same_model_replacement: ใช้ในกรณีที่พบปัญหาด้านฮาร์ดแวร์และมีการเปลี่ยนอุปกรณ์เป็นรุ่นเดียวกันหรือมีการเปลี่ยนรุ่นที่เหมือนกันจากผู้ให้บริการ / ผู้ผลิต
  • upgrade_transfer: ใช้ในกรณีที่จะเปลี่ยนอุปกรณ์ที่พร้อมใช้งานในระบบคลาวด์ด้วย Chromebook ภายใน 1 ปี