Method: customer.devices.chromeos.batchChangeStatus

Thay đổi trạng thái của một lô 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, sử dụng lại 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)
}
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.
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 thông tin này nếu đặt "changeChromeOsDeviceStatusAction" 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 về việc thay đổi trạng thái của một lô 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 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 cho thiết bị ChromeOS. Nếu không sử 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 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 được liên kết với thiết bị, hành động này có thể trả lại 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 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. Thao tác này sẽ giúp thiết bị vẫn được quản lý, do đó, thiết bị vẫn sẽ nhận được chính sách nhưng không ai có thể sử dụng thiết bị đó. Tuỳ thuộc vào bản nâng cấp được liên kết với thiết bị, hành động này có thể trả lại 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 thiết bị ChromeOS để sử dụng sau khi bị tắt. Bật lại thiết bị sau 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 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ị, thao tác này có thể sử dụng một giấy phép trong nhóm giấy phép, nghĩa là nếu không có đủ giấy phép thì 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 hợp hợp nhất result.

result chỉ có thể là một trong những loại sau:
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 trạng thái thành công.

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 lớp 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ý mô hình lỗi này 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à 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 hiển thị với người dùng đều phải được bản địa hoá và gửi trong trường google.rpc.Status.details hoặc do ứng dụng bản địa hoá.
details[]

object

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

Một đối tượng chứa các trường thuộc một loại tuỳ ý. Một trường bổ sung "@type" chứa URI xác định loại. 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 việc thay đổi trạng thái thiết bị ChromeOS thành công.