Method: chromeosdevices.action

Thay vào đó, hãy sử dụng BatchChangeChromeOsDeviceStatus. Thực hiện một hành động ảnh hưởng đến một thiết bị Chrome OS. Điều này bao gồm cả việc huỷ cấp phép, tắt và bật lại thiết bị.

Yêu cầu HTTP

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

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

Tham số đường dẫn

Thông số
customerId

string

Mã nhận dạng duy nhất cho tài khoản Google Workspace của khách hàng. Là quản trị viên tài khoản, bạn cũng có thể sử dụng bí danh my_customer để đại diện cho customerId của tài khoản. customerId cũng được trả về như một phần của tài nguyên Người dùng.
resourceId

string

Mã nhận dạng duy nhất của thiết bị. resourceId được trả về trong phản hồi từ phương thức chromeosdevices.list.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của ChromeOsDeviceAction.

Nội dung phản hồi

Nếu thành công thì phản hồi sẽ là một phản hồi HTTP chung có định dạng được xác định bằng phương thức.

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.

ChromeOsDeviceAction

Dữ liệu về lần cập nhật trạng thái của thiết bị Chrome OS.

Biểu diễn dưới dạng JSON 
{
  "action": string,
  "deprovisionReason": string
}
Các trường
action

string

chromeosdevices.action sẽ được thực hiện trên thiết bị Chrome OS.

Các giá trị được chấp nhận là:

  • deprovision: Xoá một thiết bị khỏi quy trình quản lý không còn hoạt động, đang được bán lại hoặc đang được gửi để trả lại / sửa chữa. Hãy sử dụng thao tác huỷ cấp phép để huỷ cấp phép thiết bị đó khỏi hoạt động quản lý.
  • disable: Nếu cho rằng một thiết bị trong tổ chức của mình đã bị mất hoặc bị đánh cắp, bạn có thể vô hiệu hoá thiết bị để không ai khác có thể sử dụng. Khi tắt thiết bị, tất cả người dùng đều có thể nhìn thấy khi bật thiết bị Chrome là màn hình thông báo rằng thiết bị đã bị tắt và thông tin liên hệ mong muốn của bạn về nơi trả lại thiết bị.
  • reenable: Bật lại một thiết bị đã tắt khi tìm thấy thiết bị thất lạc hoặc trả lại thiết bị thất lạc. Bạn cũng có thể sử dụng tính năng này nếu vô tình đánh dấu một thiết bị Chrome là đã tắt.
  • pre_provisioned_disable: Thiết bị được cấp phép trước không thể đăng ký. Quản trị viên có thể bật lại thiết bị để cho phép Thiết lập tự động bằng cách thay đổi trạng thái thành "pre_vendored_reenable". Lưu ý: Bạn có thể huỷ cấp phép thiết bị từ trạng thái này.
  • pre_provisioned_reenable: Thiết bị được OEM cấp phép trước. Các thiết bị ở trạng thái này đủ điều kiện để Thiết lập tự động.
deprovisionReason

string

Chỉ được sử dụng khi hành động bị huỷ cấp phép. Khi thực hiện hành động huỷ cấp phép, bạn cần điền vào trường này.

Các giá trị được chấp nhận là:

  • different_model_replacement: Sử dụng nếu bạn đang nâng cấp hoặc thay thế thiết bị bằng mẫu mới hơn của cùng thiết bị.
  • retiring_device: Sử dụng nếu bạn bán lại, quyên góp hoặc ngừng sử dụng vĩnh viễn thiết bị.
  • same_model_replacement: Sử dụng nếu thiết bị gặp phải sự cố phần cứng và thiết bị đó đang được thay thế bằng cùng một kiểu máy hoặc thiết bị thay thế tương tự của nhà cung cấp / nhà sản xuất sửa chữa.
  • upgrade_transfer: Sử dụng nếu bạn thay thế các thiết bị có tính năng Cloud Ready bằng Chromebook trong vòng một năm.