เปลี่ยนสถานะของอุปกรณ์ ChromeOS เป็นกลุ่ม ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงสถานะอุปกรณ์ ChromeOS ได้ที่หัวข้อซ่อมแซม เปลี่ยนวัตถุประสงค์การใช้งาน หรือเลิกใช้อุปกรณ์ ChromeOS
คำขอ HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
customerId |
ต้องระบุ รหัสที่เปลี่ยนแปลงไม่ได้ของบัญชี Google Workspace |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "deviceIds": [ string ], "changeChromeOsDeviceStatusAction": enum ( |
ช่อง | |
---|---|
deviceIds[] |
ต้องระบุ รายการรหัสของอุปกรณ์ ChromeOS ที่จะเปลี่ยนแปลง สูงสุด 50 รายการ |
changeChromeOsDeviceStatusAction |
ต้องระบุ การดําเนินการที่ต้องทำในอุปกรณ์ ChromeOS เพื่อเปลี่ยนสถานะ |
deprovisionReason |
ไม่บังคับ สาเหตุของการยกเลิกการจัดสรรอุปกรณ์ ต้องระบุหากตั้งค่า "changeChromeOsDeviceStatusAction" เป็น "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION" หรือข้ามช่องนี้ |
เนื้อหาการตอบกลับ
การตอบสนองเมื่อเปลี่ยนสถานะของอุปกรณ์ ChromeOS กลุ่มหนึ่ง
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"changeChromeOsDeviceStatusResults": [
{
object ( |
ช่อง | |
---|---|
changeChromeOsDeviceStatusResults[] |
ผลลัพธ์สำหรับอุปกรณ์ ChromeOS แต่ละเครื่องที่ระบุไว้ในคำขอ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/admin.directory.device.chromeos
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์
ChangeChromeOsDeviceStatusAction
การดำเนินการที่ต้องทำเพื่อเปลี่ยนสถานะของอุปกรณ์ ChromeOS
Enum | |
---|---|
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED |
ค่าเริ่มต้น ไม่ได้ใช้ค่า |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION |
ยกเลิกการจัดสรรอุปกรณ์ ChromeOS หากมีอุปกรณ์ ChromeOS ที่ไม่ได้ใช้งานในองค์กรแล้ว คุณควรยกเลิกการจัดสรรอุปกรณ์เพื่อไม่ต้องจัดการอุปกรณ์อีกต่อไป การยกเลิกการจัดสรรอุปกรณ์จะนำนโยบายทั้งหมดในอุปกรณ์ออก รวมทั้งเครื่องพิมพ์ที่ระดับอุปกรณ์และความสามารถในการใช้อุปกรณ์เป็นคีออสก์ การดำเนินการนี้อาจปล่อยใบอนุญาตกลับไปยังกลุ่มใบอนุญาต ซึ่งทำให้คุณใช้ใบอนุญาตในอุปกรณ์อื่นได้ ทั้งนี้ขึ้นอยู่กับการอัปเกรดที่เชื่อมโยงกับอุปกรณ์ |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE |
ปิดใช้อุปกรณ์ ChromeOS ใช้การดำเนินการนี้หากผู้ใช้ทำอุปกรณ์หายหรือถูกขโมย อุปกรณ์จะยังได้รับการจัดการอยู่ ดังนั้นจึงยังคงได้รับนโยบาย แต่จะไม่มีใครใช้งานได้ การดำเนินการนี้อาจปล่อยใบอนุญาตกลับไปยังกลุ่มใบอนุญาต ซึ่งทำให้คุณใช้ใบอนุญาตในอุปกรณ์อื่นได้ ทั้งนี้ขึ้นอยู่กับการอัปเกรดที่เชื่อมโยงกับอุปกรณ์ |
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE |
ทำให้ใช้อุปกรณ์ ChromeOS ได้อีกครั้งหลังจากปิดใช้ เปิดใช้อุปกรณ์อีกครั้งเมื่ออุปกรณ์ไม่สูญหายหรือได้รับการกู้คืนแล้ว ซึ่งจะทำให้อุปกรณ์นี้กลับมาใช้งานได้อีกครั้ง การดำเนินการนี้อาจใช้ใบอนุญาต 1 รายการจากกลุ่มใบอนุญาต ซึ่งหมายความว่าหากมีใบอนุญาตไม่เพียงพอ การดำเนินการจะล้มเหลว ทั้งนี้ขึ้นอยู่กับการอัปเกรดที่เชื่อมโยงกับอุปกรณ์ |
ChangeChromeOsDeviceStatusResult
ผลลัพธ์ของอุปกรณ์ ChromeOS เครื่องเดียวสําหรับการดําเนินการเปลี่ยนสถานะ
การแสดง JSON |
---|
{ "deviceId": string, // Union field |
ช่อง | |
---|---|
deviceId |
รหัสที่ไม่ซ้ำกันของอุปกรณ์ ChromeOS |
ฟิลด์การรวม
|
|
error |
ผลข้อผิดพลาดของการดำเนินการในกรณีที่ดำเนินการไม่สำเร็จ |
response |
อุปกรณ์เปลี่ยนสถานะได้สำเร็จ |
สถานะ
ประเภท Status
กำหนดโมเดลข้อผิดพลาดเชิงตรรกะที่เหมาะสำหรับสภาพแวดล้อมการเขียนโปรแกรมที่แตกต่างกัน ซึ่งรวมถึง REST API และ RPC API ใช้โดย gRPC ข้อความ Status
แต่ละข้อความจะมีข้อมูล 3 อย่าง ได้แก่ รหัสข้อผิดพลาด ข้อความแสดงข้อผิดพลาด และรายละเอียดข้อผิดพลาด
ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบข้อผิดพลาดนี้และวิธีทำงานกับรูปแบบดังกล่าวได้ในคู่มือการออกแบบ API
การแสดง JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
ช่อง | |
---|---|
code |
รหัสสถานะ ซึ่งควรเป็นค่า enum ของ |
message |
ข้อความแสดงข้อผิดพลาดที่ส่งถึงนักพัฒนาซอฟต์แวร์ ซึ่งควรเป็นภาษาอังกฤษ ข้อความแสดงข้อผิดพลาดที่แสดงต่อผู้ใช้ควรแปลและส่งในช่อง |
details[] |
รายการข้อความที่มีรายละเอียดข้อผิดพลาด มีชุดประเภทข้อความที่ใช้กันโดยทั่วไปสำหรับ API ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
ChangeChromeOsDeviceStatusSucceeded
ประเภทนี้ไม่มีช่อง
การตอบสนองสำหรับการเปลี่ยนสถานะอุปกรณ์ ChromeOS ที่สำเร็จ