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 thiết bị ChromeOS. Điều này bao gồm 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

Tham số
customerId

string

Mã nhận dạng duy nhất của 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ị. Các 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à phản hồi HTTP chung có định dạng được 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ề quá trình 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
}
Trường
action

string

chromeosdevices.action cần thực hiện trên thiết bị Chrome OS.

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

  • deprovision: Xoá khỏi mục quản lý một 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 để 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 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 cho biết 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ị đã 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 tính năng Đăng ký tự động bằng cách thay đổi trạng thái thành "pre_PROVed_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 OEM cấp phép sẵn. 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 huỷ cấp phép. Trường này là bắt buộc với thao tác huỷ cấp phép.

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

  • different_model_replacement: Dùng nếu bạn muốn 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 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 khi thiết bị gặp phải vấn đề về phần cứng và thiết bị đó đang bị thay thế bằng cùng mẫu hoặc thiết bị thay thế theo mẫu tương tự của nhà cung cấp dịch vụ sửa chữa / nhà sản xuất.
  • upgrade_transfer: Sử dụng nếu bạn sắp thay thế thiết bị có tính năng Cloud Ready bằng Chromebook trong vòng một năm.