Method: customer.devices.chromeos.batchChangeStatus

เปลี่ยนสถานะของอุปกรณ์ ChromeOS เป็นกลุ่ม ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงสถานะอุปกรณ์ ChromeOS ได้ที่หัวข้อซ่อมแซม เปลี่ยนวัตถุประสงค์การใช้งาน หรือเลิกใช้อุปกรณ์ ChromeOS

คำขอ HTTP

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

ต้องระบุ รหัสที่เปลี่ยนแปลงไม่ได้ของบัญชี Google Workspace

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
ช่อง
deviceIds[]

string

ต้องระบุ รายการรหัสของอุปกรณ์ ChromeOS ที่จะเปลี่ยนแปลง สูงสุด 50 รายการ
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

ต้องระบุ การดําเนินการที่ต้องทำในอุปกรณ์ ChromeOS เพื่อเปลี่ยนสถานะ
deprovisionReason

enum (DeprovisionReason)

ไม่บังคับ สาเหตุของการยกเลิกการจัดสรรอุปกรณ์ ต้องระบุหากตั้งค่า "changeChromeOsDeviceStatusAction" เป็น "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION" หรือข้ามช่องนี้

เนื้อหาการตอบกลับ

การตอบสนองเมื่อเปลี่ยนสถานะของอุปกรณ์ ChromeOS กลุ่มหนึ่ง

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
ช่อง
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

ผลลัพธ์สำหรับอุปกรณ์ 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 result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
ช่อง
deviceId

string

รหัสที่ไม่ซ้ำกันของอุปกรณ์ ChromeOS

ฟิลด์การรวม result

result ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
error

object (Status)

ผลข้อผิดพลาดของการดำเนินการในกรณีที่ดำเนินการไม่สำเร็จ
response

object (ChangeChromeOsDeviceStatusSucceeded)

อุปกรณ์เปลี่ยนสถานะได้สำเร็จ

สถานะ

ประเภท Status กำหนดโมเดลข้อผิดพลาดเชิงตรรกะที่เหมาะสำหรับสภาพแวดล้อมการเขียนโปรแกรมที่แตกต่างกัน ซึ่งรวมถึง REST API และ RPC API ใช้โดย gRPC ข้อความ Status แต่ละข้อความจะมีข้อมูล 3 อย่าง ได้แก่ รหัสข้อผิดพลาด ข้อความแสดงข้อผิดพลาด และรายละเอียดข้อผิดพลาด

ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบข้อผิดพลาดนี้และวิธีทำงานกับรูปแบบดังกล่าวได้ในคู่มือการออกแบบ API

การแสดง JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
ช่อง
code

integer

รหัสสถานะ ซึ่งควรเป็นค่า enum ของ google.rpc.Code
message

string

ข้อความแสดงข้อผิดพลาดที่ส่งถึงนักพัฒนาซอฟต์แวร์ ซึ่งควรเป็นภาษาอังกฤษ ข้อความแสดงข้อผิดพลาดที่แสดงต่อผู้ใช้ควรแปลและส่งในช่อง google.rpc.Status.details หรือไคลเอ็นต์แปล
details[]

object

รายการข้อความที่มีรายละเอียดข้อผิดพลาด มีชุดประเภทข้อความที่ใช้กันโดยทั่วไปสำหรับ API

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }

ChangeChromeOsDeviceStatusSucceeded

ประเภทนี้ไม่มีช่อง

การตอบสนองสำหรับการเปลี่ยนสถานะอุปกรณ์ ChromeOS ที่สำเร็จ