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: ใช้ในกรณีที่จะเปลี่ยนจากอุปกรณ์ที่ใช้ CloudReady ไปใช้ Chromebook ภายใน 1 ปี