ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM).
مزيد من المعلومات
Enterprises: generateSignupUrl
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تنشئ عنوان URL للاشتراك.
الطلب
طلب HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
المعلمات
| اسم المعلَمة |
القيمة |
الوصف |
| مَعلمات طلب البحث الاختيارية |
adminEmail |
string |
اختياريّ. عنوان البريد الإلكتروني المستخدَم لملء حقل المشرف في نموذج تسجيل
الاشتراك في المؤسسة مسبقًا هذه القيمة هي تلميح فقط ويمكن للمستخدم تغييرها.
إذا لم تكن قيمة allowedDomains فارغة، يجب أن تنتمي هذه القيمة إلى أحد
allowedDomains.
|
allowedDomains |
string |
اختياريّ. قائمة بالنطاقات المسموح بها لعنوان البريد الإلكتروني الخاص بالمشرف لا يمكن لمدير تكنولوجيا المعلومات إدخال عنوان بريد إلكتروني يحتوي على اسم نطاق غير مُدرَج في
هذه القائمة. لا يُسمح بالنطاقات الفرعية للنطاقات المدرَجة في هذه القائمة، ولكن يمكن
السماح بها من خلال إضافة إدخال ثانٍ يتضمّن البادئة "*." إلى اسم
النطاق (مثل *.example.com). إذا لم يكن الحقل متوفّرًا أو كان قائمة فارغة،
يكون مشرف تكنولوجيا المعلومات حرًا في استخدام أي اسم نطاق صالح. يُسمح دائمًا بنطاقات البريد الإلكتروني
الشخصية، ولكن سيؤدي ذلك إلى إنشاء "حسابات Google Play للأعمال".
|
callbackUrl |
string |
عنوان URL لردّ الاتصال الذي ستتم إعادة توجيه المشرف إليه بعد
إنشاء مؤسسة بنجاح. قبل إعادة التوجيه إلى هذا العنوان، سيضيف النظام مَعلمة طلب بحث واحدة إلى عنوان URL هذا باسم "enterpriseToken" والتي ستشمل رمزًا غير شفاف ليتم استخدامه في طلب CompleteSignup.
يعني ذلك أنّه سيتم تحليل عنوان URL وإضافة المَعلمة
ثم تنسيق عنوان URL جديد، أي قد تكون هناك بعض التغييرات الطفيفة في التنسيق
، والأهم من ذلك، يجب أن يكون عنوان URL منسقًا بشكل جيد لكي تتمكّن من
تحليله.
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
| النطاق |
|---|
https://www.googleapis.com/auth/androidenterprise |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
لا تقدِّم محتوى طلب باستخدام هذه الطريقة.
الردّ
إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:
{
"kind": string,
"url": string,
"completionToken": string
}
| اسم السمة |
القيمة |
الوصف |
ملاحظات |
url |
string |
عنوان URL يمكن للمشرف من خلاله الاشتراك في مؤسسة. لا يمكن عرض الصفحة التي تتم الإشارة إليها في إطار iframe. |
|
completionToken |
string |
رمز مميز غير شفاف سيكون مطلوبًا، إلى جانب رمز Enterprise Token، للحصول على مورد المؤسسة من CompleteSignup. |
|
kind |
string |
تم إيقاف هذا العمود نهائيًا.
|
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGenerates a sign-up URL for Android enterprise enrollment using the \u003ccode\u003esignupUrl\u003c/code\u003e endpoint with an optional admin email and callback URL.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful signup, a response provides a sign-up URL for the admin and a completion token for finalizing the process with the \u003ccode\u003eCompleteSignup\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary to use this endpoint.\u003c/p\u003e\n"]]],[],null,["# Enterprises: generateSignupUrl\n\n| **Note:** Requires [authorization](#auth).\n\nGenerates a sign-up URL.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Optional query parameters** |||\n| `adminEmail` | `string` | Optional. Email address used to prefill the admin field of the enterprise signup form. This value is a hint only and can be altered by the user. If \\`allowedDomains\\` is non-empty then this must belong to one of the \\`allowedDomains\\`. |\n| `allowedDomains` | `string` | Optional. A list of domains that are permitted for the admin email. The IT admin cannot enter an email address with a domain name that is not in this list. Subdomains of domains in this list are not allowed but can be allowed by adding a second entry which has \\`\\*.\\` prefixed to the domain name (e.g. \\*.example.com). If the field is not present or is an empty list then the IT admin is free to use any valid domain name. Personal email domains are always allowed, but will result in the creation of a managed Google Play Accounts enterprise. |\n| `callbackUrl` | `string` | The callback URL to which the Admin will be redirected after successfully creating an enterprise. Before redirecting there the system will add a single query parameter to this URL named \"enterpriseToken\" which will contain an opaque token to be used for the CompleteSignup request. Beware that this means that the URL will be parsed, the parameter added and then a new URL formatted, i.e. there may be some minor formatting changes and, more importantly, the URL must be well-formed so that it can be parsed. |\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\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": string,\n \"url\": string,\n \"completionToken\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `url` | `string` | A URL under which the Admin can sign up for an enterprise. The page pointed to cannot be rendered in an iframe. | |\n| `completionToken` | `string` | An opaque token that will be required, along with the Enterprise Token, for obtaining the enterprise resource from CompleteSignup. | |\n| `kind` | `string` | Deprecated. | |"]]
