Method: chromeosdevices.action

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

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