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 ที่สำเร็จ