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 xem bài viết 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

Thông 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)
}
Các trường
deviceIds[]

string

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

enum (ChangeChromeOsDeviceStatusAction)

Bắt buộc. Hành động 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 thông tin này nếu giá trị "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)
    }
  ]
}
Các 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

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

Enum
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED Giá trị mặc định. Giá trị chưa được sử dụng.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION Huỷ cấp phép một thiết bị ChromeOS. Nếu không dùng các thiết bị ChromeOS trong tổ chức nữa, bạn nên huỷ cấp phép các thiết bị đó để không cần quản lý nữa. Việc hủy cấp phép thiết bị sẽ xóa 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 được liên kết với thiết bị, thao tác này có thể giải phóng giấy phép trở lại nhóm giấy phép. Điều này 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 sử 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. Việc này nhằm đảm bảo thiết bị vẫn được quản lý, nên thiết bị sẽ vẫn nhận được cá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 được liên kết với thiết bị, thao tác này có thể giải phóng giấy phép trở lại nhóm giấy phép. Điều này 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 thiết bị ChromeOS để sử dụng sau khi đã tắt. Bật lại thiết bị khi thiết bị không còn bị mất hoặc được khôi phục. Thao tác này cho phép bạn dùng lại thiết bị. Tuỳ thuộc vào bản nâng cấp được 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, có nghĩa là nếu không có đủ giấy phép thì thao tác này sẽ không thành công.

ChangeChromeOsDeviceStatusResult

Kết quả của một thiết bị ChromeOS duy nhất 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.
}
Các trường
deviceId

string

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

Trường nhóm 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ị này có thể thay đổi thành công trạng thái của thiết bị.

Trạng thái

Loại Status xác định một 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. gRPC sử dụng khoá này. 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 và cách xử lý lỗi 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: ...,
      ...
    }
  ]
}
Các trường
code

integer

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

string

Một 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 phải được bản địa hoá và gửi trong trường google.rpc.Status.details hoặc đượ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 tập hợp các loại thông báo phổ biến để API sử dụng.

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

ChangeChromeOsDeviceStatusSucceeded

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

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