重要資訊:我們目前不接受新的 Play EMM API 註冊。
瞭解詳情。
Devices: update
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
更新裝置政策。
如要確保政策正確強制執行,請防止未受管
將存取 Google Play 的使用者帳戶設為
Google Cloud 控制台的受管理設定中的 allowed_accounts
Play 套件。查看限制
帳戶
要求
HTTP 要求
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId
參數
參數名稱 |
值 |
說明 |
路徑參數 |
deviceId |
string |
裝置的 ID。
|
enterpriseId |
string |
企業的 ID。
|
userId |
string |
使用者的 ID。
|
選用的查詢參數 |
updateMask |
string |
用於識別待更新欄位的遮罩。如未設定,則完全可修改
欄位。
如果在查詢參數中設定這個欄位,應將這個欄位指定為
updateMask=<field1>,<field2>,...
|
授權
此要求需要具有下列範圍的授權:
範圍 |
https://www.googleapis.com/auth/androidenterprise |
詳情請參閱「驗證與授權」網頁。
要求主體
在要求主體中,提供裝置資源。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-10-14 (世界標準時間)。
[null,null,["上次更新時間:2024-10-14 (世界標準時間)。"],[[["\u003cp\u003eThis operation updates a device's policy, requiring authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eTo enforce the policy effectively, it's crucial to restrict unmanaged accounts from accessing Google Play by configuring \u003ccode\u003eallowed_accounts\u003c/code\u003e in the managed configuration for the Google Play package.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify which fields to update using the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter, otherwise all modifiable fields will be changed.\u003c/p\u003e\n"],["\u003cp\u003eThe request utilizes a PUT method and targets a specific URL structure including enterprise ID, user ID, and device ID.\u003c/p\u003e\n"],["\u003cp\u003eA successful operation returns a \u003ccode\u003eDevices\u003c/code\u003e resource, reflecting the updated device policy information.\u003c/p\u003e\n"]]],[],null,["# Devices: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates the device policy.\n\n\u003cbr /\u003e\n\n\nTo ensure the policy is properly enforced, you need to prevent unmanaged\naccounts from accessing Google Play by setting the\n`allowed_accounts` in the managed configuration for the Google\nPlay package. See [restrict\naccounts in Google Play](https://developer.android.com/work/dpc/security#google-play-accounts).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId\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| **Optional query parameters** |||\n| `updateMask` | `string` | Mask that identifies which fields to update. If not set, all modifiable fields will be modified. \u003cbr /\u003e When set in a query parameter, this field should be specified as `updateMask=\u003cfield1\u003e,\u003cfield2\u003e,...` |\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 a [Devices resource](/android/work/play/emm-api/v1/devices#resource).\n\nResponse\n--------\n\nIf successful, this method returns a [Devices resource](/android/work/play/emm-api/v1/devices#resource) in the response body."]]