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 ปี
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-08-22 UTC
[null,null,["อัปเดตล่าสุด 2024-08-22 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."]]],[]]