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