重要資訊:我們目前不接受新的 Play EMM API 註冊。
瞭解詳情。
Users: update
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
更新 EMM 管理使用者的詳細資料。
僅適用於受 EMM 管理的使用者 (而非 Google 受管理使用者)。
在
使用者
將資源傳送至要求主體中僅限 displayName
欄位
可以變更其他欄位則不得設定或含有
目前使用的值。
要求
HTTP 要求
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId
參數
參數名稱 |
值 |
說明 |
路徑參數 |
enterpriseId |
string |
企業的 ID。
|
userId |
string |
使用者的 ID。
|
授權
此要求需要具有下列範圍的授權:
範圍 |
https://www.googleapis.com/auth/androidenterprise |
詳情請參閱「驗證與授權」網頁。
要求主體
在要求主體中,提供 Users 資源並附上以下屬性:
屬性名稱 |
值 |
說明 |
附註 |
選用屬性 |
displayName |
string |
顯示在使用者介面中的名稱。建立由 EMM 管理的使用者時,您可以選擇是否要設定這項屬性。如已設定這項屬性,請使用與機構相關的通用名稱 (例如「Example, Inc.」) 或您的姓名 (例如 EMM)。不適用於由 Google 管理的使用者帳戶。 |
可寫入
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eUpdates the \u003ccode\u003edisplayName\u003c/code\u003e of an EMM-managed user, requiring authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request must be a \u003ccode\u003ePUT\u003c/code\u003e request sent to \u003ccode\u003ehttps://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId\u003c/code\u003e, replacing \u003ccode\u003eenterpriseId\u003c/code\u003e and \u003ccode\u003euserId\u003c/code\u003e with their respective values.\u003c/p\u003e\n"],["\u003cp\u003eOnly the \u003ccode\u003edisplayName\u003c/code\u003e field can be updated; all other fields must remain unchanged or unset.\u003c/p\u003e\n"],["\u003cp\u003eThis operation is exclusively for EMM-managed users and is not applicable to Google-managed users.\u003c/p\u003e\n"]]],[],null,["# Users: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates the details of an EMM-managed user.\n\n\u003cbr /\u003e\n\n\nCan be used with EMM-managed users only (not Google managed users).\nPass the new details in the\n[Users](/android/work/play/emm-api/v1/users)\nresource in the request body. Only the `displayName` field\ncan be changed. Other fields must either be unset or have the\ncurrently active value.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\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 a [Users resource](/android/work/play/emm-api/v1/users#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| **Optional Properties** ||||\n| `displayName` | `string` | The name that will appear in user interfaces. Setting this property is optional when creating EMM-managed users. If you do set this property, use something generic about the organization (such as \"Example, Inc.\") or your name (as EMM). Not used for Google-managed user accounts. | writable |\n\nResponse\n--------\n\nIf successful, this method returns a [Users resource](/android/work/play/emm-api/v1/users#resource) in the response body."]]