Method: chromeosdevices.action

Thay vào đó, hãy sử dụng BatchChangeChromeOsDeviceStatus. Thực hiện hành động ảnh hưởng đến Thiết bị Chrome OS. Chỉ số 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, phản hồi sẽ là một phản hồi HTTP chung có định dạng do phương thức xác định.

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ề nội dung cập nhật trạng thái của một thiết bị Chrome OS.

Biểu diễn dưới dạng JSON 
{
  "action": string,
  "deprovisionReason": string
}
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 hoạt động quản lý vì thiết bị đó 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 để tách 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 bạn đã 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 thiết bị bị tắt, tất cả những gì người dùng có thể nhìn thấy khi bật thiết bị Chrome sẽ là màn hình thông báo rằng thiết bị đã bị tắt và thông tin liên hệ mà bạn muốn biết 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ị bị thất lạc hoặc trả lại thiết bị bị mất. 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: Một thiết bị được cấp phép sẵn không thể đăng ký. Quản trị viên có thể bật lại thiết bị để cho phép Quy trình đăng ký không tiếp xúc bằng cách thay đổi trạng thái thành "pre_provisioned_reenable". Lưu ý: Ở trạng thái này, bạn có thể huỷ cấp phép thiết bị.
  • pre_provisioned_reenable: Thiết bị được nhà sản xuất thiết bị gốc (OEM) cấp trước. Các thiết bị ở trạng thái này đủ điều kiện để Đăng ký tự động.
deprovisionReason

string

Chỉ được dùng khi hành động bị huỷ cấp phép. Với thao tác huỷ cấp phép, trường này là bắt buộc.

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ột mẫu mới hơn của cùng một 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ị này.
  • same_model_replacement: Sử dụng nếu thiết bị gặp sự cố phần cứng và thiết bị đó đang được thay thế bằng cùng một mẫu hoặc một mẫu 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 định thay thế thiết bị có tính năng Cloud Ready bằng Chromebook trong vòng một năm.