ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM).
مزيد من المعلومات
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" أو "مادة العرض رقم 44418" لا تستخدِم معلومات تحديد الهوية الشخصية لهذا الموقع. يجب ضبطها دائمًا للمستخدمين المُدارين من خلال إدارة الخدمات الجوّالة للمؤسسات (EMM). لم يتم ضبطه للمستخدمين الخاضعين لإدارة Google. |
|
accountType |
string |
نوع الحساب الذي يمثله هذا المستخدم. يمكن تثبيت userAccount على أجهزة متعددة، ولكن deviceAccount خاص بجهاز واحد. يمكن أن يكون المستخدم المُدار من خلال إدارة الخدمات الجوّالة للمؤسسات (emmManaged) أيًا من النوعين (userAccount، deviceAccount)، ولكن المستخدم الذي تديره Google (googleManaged) دائمًا ما يكون userAccount.
في ما يلي القيم المقبولة:
- "
deviceAccount"
- "
userAccount"
|
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
