חשוב: אנחנו לא מקבלים יותר רישומים חדשים עבור Play EMM API.
מידע נוסף
Users: insert
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת משתמש חדש בניהול EMM.
המשאב משתמשים
שמועברים בגוף הבקשה צריכה לכלול
accountIdentifier ו-accountType.
אם כבר קיים משתמש מתאים עם אותו מזהה חשבון,
המשתמש יעודכן עם המשאב. במקרה הזה רק
אפשר לשנות את השדה displayName.
בקשה
בקשת HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
פרמטרים
| שם הפרמטר |
ערך |
תיאור |
| פרמטרים של נתיב |
enterpriseId |
string |
המזהה של הארגון.
|
אישור
הבקשה הזו מחייבת הרשאה עם ההיקף הבא:
| היקף |
|---|
https://www.googleapis.com/auth/androidenterprise |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מציינים משאב משתמשים עם המאפיינים הבאים:
| שם הנכס |
ערך |
תיאור |
הערות |
| המאפיינים הנדרשים |
accountIdentifier |
string |
מזהה ייחודי שיצרת למשתמש הזה, כמו user342 או "asset#44418". אין להשתמש בפרטים אישיים מזהים (PII) עבור הנכס הזה. חובה להגדיר תמיד למשתמשים שמנוהלים על ידי EMM. לא מוגדר למשתמשים המנוהלים על ידי Google. |
|
accountType |
string |
סוג החשבון שהמשתמש מייצג. אפשר להתקין userAccount בכמה מכשירים, אבל deviceAccount הוא ספציפי למכשיר אחד. משתמש שמנוהל על ידי EMM (emmManaged) יכול להיות משני הסוגים (userAccount, deviceAccount), אבל משתמש בניהול Google (googleManaged) הוא תמיד userAccount.
הערכים הקבילים הם:
- "
deviceAccount"
- "
userAccount"
|
|
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה משאב Users בגוף התגובה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003eCreates or updates an EMM-managed user within a specified enterprise.\u003c/p\u003e\n"],["\u003cp\u003eRequires an \u003ccode\u003eaccountIdentifier\u003c/code\u003e and \u003ccode\u003eaccountType\u003c/code\u003e to define the user.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to the \u003ccode\u003e/enterprises/enterpriseId/users\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003edisplayName\u003c/code\u003e is the only field that can be updated for existing users.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary.\u003c/p\u003e\n"]]],[],null,["# Users: insert\n\n| **Note:** Requires [authorization](#auth).\n\nCreates a new EMM-managed user.\n\n\u003cbr /\u003e\n\n\nThe [Users](/android/work/play/emm-api/v1/users) resource\npassed in the body of the request should include an\n`accountIdentifier` and an `accountType`.\n\nIf a corresponding user already exists with the same account identifier,\nthe user will be updated with the resource. In this case only the\n`displayName` field can be changed.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\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| **Required Properties** ||||\n| `accountIdentifier` | `string` | A unique identifier you create for this user, such as \"user342\" or \"asset#44418\". Do not use personally identifiable information (PII) for this property. Must always be set for EMM-managed users. Not set for Google-managed users. | |\n| `accountType` | `string` | The type of account that this user represents. A `userAccount` can be installed on multiple devices, but a `deviceAccount` is specific to a single device. An EMM-managed user (`emmManaged`) can be either type (`userAccount`, `deviceAccount`), but a Google-managed user (`googleManaged`) is always a `userAccount`. \u003cbr /\u003e Acceptable values are: - \"`deviceAccount`\" - \"`userAccount`\" | |\n\nResponse\n--------\n\nIf successful, this method returns a [Users resource](/android/work/play/emm-api/v1/users#resource) in the response body."]]
