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 ปี
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-11-09 UTC
[null,null,["อัปเดตล่าสุด 2024-11-09 UTC"],[[["This API (`customer.devices.chromeos/action`) is deprecated and `BatchChangeChromeOsDeviceStatus` should be used instead."],["It allows administrators to manage the status of Chrome OS devices, including deprovisioning, disabling, and re-enabling."],["Deprovisioning removes device management, disabling prevents usage (ideal for lost/stolen devices), and re-enabling restores device access."],["Before re-enrollment, deprovisioned devices require wiping, and re-enabling a device consumes a device license."]]],[]]