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 ปี