Lưu ý quan trọng: Chúng tôi không còn chấp nhận các lượt đăng ký mới cho Play EMM API.
Tìm hiểu thêm.
Devices: setState
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Đặt quyền truy cập của một thiết bị vào các dịch vụ của Google ở trạng thái bật hay tắt.
Trạng thái thiết bị chỉ có hiệu lực nếu bạn bật chế độ thực thi chính sách EMM trên thiết bị Android trong Bảng điều khiển dành cho quản trị viên của Google.
Nếu không, trạng thái thiết bị sẽ bị bỏ qua và mọi thiết bị đều được phép truy cập
vào các dịch vụ của Google.
Tính năng này chỉ được hỗ trợ cho người dùng do Google quản lý.
Yêu cầu
Yêu cầu HTTP
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state
Thông số
| Tên thông số |
Giá trị |
Mô tả |
| Tham số đường dẫn |
deviceId |
string |
Mã thiết bị.
|
enterpriseId |
string |
Mã doanh nghiệp.
|
userId |
string |
Mã của người dùng.
|
Ủy quyền
Yêu cầu này yêu cầu được uỷ quyền với phạm vi sau:
| Phạm vi |
|---|
https://www.googleapis.com/auth/androidenterprise |
Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.
Nội dung yêu cầu
Trong nội dung yêu cầu, hãy cung cấp dữ liệu theo cấu trúc sau:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
accountState |
string |
Trạng thái của Tài khoản Google trên thiết bị. "đã bật" cho biết rằng bạn có thể dùng Tài khoản Google trên thiết bị để truy cập vào các dịch vụ của Google (bao gồm cả Google Play), còn "đã tắt" có nghĩa là bạn không thể dùng tài khoản đó. Một thiết bị mới ban đầu ở trạng thái "bị vô hiệu hoá" trạng thái.
Các giá trị được chấp nhận là:
|
|
kind |
string |
|
|
Phản hồi
Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:
{
"kind": "androidenterprise#deviceState",
"accountState": string
}
| Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
accountState |
string |
Trạng thái của Tài khoản Google trên thiết bị. "đã bật" cho biết rằng bạn có thể dùng Tài khoản Google trên thiết bị để truy cập vào các dịch vụ của Google (bao gồm cả Google Play), còn "đã tắt" có nghĩa là bạn không thể dùng tài khoản đó. Một thiết bị mới ban đầu ở trạng thái "bị vô hiệu hoá" trạng thái.
Các giá trị được chấp nhận là:
|
|
kind |
string |
|
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-09-12 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-09-12 UTC."],[[["\u003cp\u003eEnables or disables a device's access to Google services for Google-managed users.\u003c/p\u003e\n"],["\u003cp\u003eDevice state enforcement requires enabling EMM policies in the Google Admin Console.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a PUT request to update the device state to either "enabled" or "disabled".\u003c/p\u003e\n"]]],[],null,["# Devices: setState\n\n| **Note:** Requires [authorization](#auth).\n\nSets whether a device's access to Google services is enabled or disabled.\nThe device state takes effect only if enforcing EMM policies on Android\ndevices is enabled in the Google Admin Console.\nOtherwise, the device state is ignored and all devices are allowed access\nto Google services.\nThis is only supported for Google-managed users.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId/state\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `deviceId` | `string` | The ID of the device. |\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| `userId` | `string` | The ID of the user. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#deviceState\",\n \"accountState\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `accountState` | `string` | The state of the Google account on the device. \"enabled\" indicates that the Google account on the device can be used to access Google services (including Google Play), while \"disabled\" means that it cannot. A new device is initially in the \"disabled\" state. \u003cbr /\u003e Acceptable values are: - \"`disabled`\" - \"`enabled`\" | |\n| `kind` | `string` | | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#deviceState\",\n \"accountState\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|----------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `accountState` | `string` | The state of the Google account on the device. \"enabled\" indicates that the Google account on the device can be used to access Google services (including Google Play), while \"disabled\" means that it cannot. A new device is initially in the \"disabled\" state. \u003cbr /\u003e Acceptable values are: - \"`disabled`\" - \"`enabled`\" | |\n| `kind` | `string` | | |"]]
