Method: customer.devices.chromeos.batchChangeStatus

Thay đổi trạng thái của một loạt thiết bị ChromeOS. Để biết thêm thông tin về cách thay đổi trạng thái của thiết bị ChromeOS, hãy Sửa chữa, chuyển đổi mục đích hoặc ngừng sử dụng thiết bị ChromeOS.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
customerId

string

Bắt buộc. Mã nhận dạng không thể thay đổi của tài khoản Google Workspace.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
Trường
deviceIds[]

string

Bắt buộc. Danh sách mã nhận dạng của những thiết bị ChromeOS cần thay đổi. Tối đa 50 ký tự.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

Bắt buộc. Thao tác cần thực hiện trên thiết bị ChromeOS để thay đổi trạng thái của thiết bị.
deprovisionReason

enum (DeprovisionReason)

Không bắt buộc. Lý do huỷ cấp phép thiết bị. Bạn phải cung cấp nếu giá trị là "changeChromeOsDeviceStatusAction" được đặt thành 'CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION'. Nếu không, hãy bỏ qua trường này.

Nội dung phản hồi

Phản hồi khi thay đổi trạng thái của một loạt thiết bị ChromeOS.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
Trường
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

Kết quả cho từng thiết bị ChromeOS được cung cấp trong yêu cầu.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

ChangeChromeOsDeviceStatusAction

Thao tác cần thực hiện để thay đổi trạng thái của một thiết bị ChromeOS.

Enum
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED Giá trị mặc định. Giá trị không được sử dụng.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION Huỷ cấp phép một thiết bị ChromeOS. Nếu tổ chức của bạn không sử dụng các thiết bị ChromeOS nữa, bạn nên huỷ cấp phép các thiết bị đó để không còn quản lý các thiết bị đó nữa. Việc huỷ cấp phép thiết bị sẽ loại bỏ tất cả các chính sách trên thiết bị cũng như máy in cấp thiết bị và khả năng sử dụng thiết bị làm kiosk. Tuỳ thuộc vào bản nâng cấp liên kết với thiết bị, thao tác này có thể giải phóng giấy phép vào nhóm giấy phép; cho phép bạn sử dụng giấy phép trên một thiết bị khác.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Tắt một thiết bị ChromeOS. Hãy áp dụng thao tác này nếu người dùng mất thiết bị hoặc thiết bị bị đánh cắp. Cách làm này giúp thiết bị vẫn được quản lý. Do đó, thiết bị sẽ vẫn nhận được chính sách nhưng không ai có thể sử dụng. Tuỳ thuộc vào bản nâng cấp liên kết với thiết bị, thao tác này có thể giải phóng giấy phép vào nhóm giấy phép; cho phép bạn sử dụng giấy phép trên một thiết bị khác.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Bật lại để sử dụng một thiết bị ChromeOS sau khi bị tắt. Kích hoạt lại thiết bị sau khi không còn bị mất hoặc đã được khôi phục. Điều này cho phép bạn sử dụng lại thiết bị. Tuỳ thuộc vào bản nâng cấp liên kết với thiết bị, quá trình này có thể sử dụng một giấy phép từ nhóm giấy phép, nghĩa là nếu không có đủ giấy phép, thao tác sẽ không thành công.

ChangeChromeOsDeviceStatusResult

Kết quả của một thiết bị ChromeOS cho thao tác Thay đổi trạng thái.

Biểu diễn dưới dạng 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.
}
Trường
deviceId

string

Mã nhận dạng duy nhất của thiết bị ChromeOS.

Trường kết hợp result.

result chỉ có thể là một trong những trạng thái sau đây:
error

object (Status)

Kết quả lỗi của thao tác trong trường hợp không thành công.
response

object (ChangeChromeOsDeviceStatusSucceeded)

Thiết bị có thể thay đổi thành công trạng thái.

Trạng thái

Loại Status xác định mô hình lỗi logic phù hợp với nhiều môi trường lập trình, bao gồm cả API REST và API RPC. Hàm này được gRPC sử dụng. Mỗi thông báo Status chứa 3 phần dữ liệu: mã lỗi, thông báo lỗi và thông tin chi tiết về lỗi.

Bạn có thể tìm hiểu thêm về mô hình lỗi này cũng như cách xử lý trong Hướng dẫn thiết kế API.

Biểu diễn dưới dạng JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Trường
code

integer

Mã trạng thái, phải là một giá trị enum của google.rpc.Code.
message

string

Thông báo lỗi dành cho nhà phát triển, phải bằng tiếng Anh. Mọi thông báo lỗi dành cho người dùng đều phải được bản địa hoá và gửi trong trường google.rpc.Status.details hoặc để ứng dụng bản địa hoá.
details[]

object

Danh sách các thông báo chứa thông tin chi tiết về lỗi. Có một nhóm loại thông báo phổ biến để API sử dụng.

Một đối tượng có chứa các trường thuộc loại tuỳ ý. Trường bổ sung "@type" chứa URI xác định kiểu. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.

ChangeChromeOsDeviceStatusSucceeded

Loại này không có trường nào.

Phản hồi cho thay đổi thành công trạng thái thiết bị ChromeOS.