مهم: ما دیگر ثبت نام های جدید برای 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 |
برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.
درخواست بدن
در بدنه درخواست، یک منبع Users با ویژگی های زیر ارائه کنید:
| نام ملک | ارزش | توضیحات | یادداشت ها |
|---|
| خواص مورد نیاز |
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
