Method: signupUrls.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لإنشاء عنوان URL للاشتراك في برنامج Enterprise
طلب HTTP
POST https://androidmanagement.googleapis.com/v1/signupUrls
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
projectId |
string
رقم تعريف مشروع Google Cloud Platform الذي سيملك المؤسسة.
|
callbackUrl |
string
عنوان URL لردّ الاتصال الذي ستتم إعادة توجيه المشرف إليه بعد إنشاء مؤسسة بنجاح. قبل إعادة التوجيه إلى هذا الرابط، سيضيف النظام مَعلمة طلب بحث إلى عنوان URL هذا باسم enterpriseToken والتي ستحتوي على رمز مميّز غير شفاف ليتم استخدامه لطلب إنشاء مؤسسة. سيتم تحليل عنوان URL ثم إعادة تنسيقه لإضافة المَعلمة enterpriseToken، لذا قد تحدث بعض التغييرات البسيطة في التنسيق.
|
adminEmail |
string
اختيارية: عنوان البريد الإلكتروني المستخدَم لملء حقل المشرف مسبقًا في نموذج الاشتراك في المؤسسة. هذه القيمة هي تلميح فقط ويمكن للمستخدم تغييرها. إذا لم تكن قيمة allowedDomainsallowedDomains
|
allowedDomains[] |
string
اختيارية: قائمة بالنطاقات المسموح بها لعنوان البريد الإلكتروني الخاص بالمشرف لا يمكن لمشرف تكنولوجيا المعلومات إدخال عنوان بريد إلكتروني يحمل اسم نطاق غير مُدرَج في هذه القائمة. لا يُسمح بالنطاقات الفرعية للنطاقات المدرَجة في هذه القائمة، ولكن يمكن السماح بها من خلال إضافة إدخال ثانٍ يتضمّن البادئة *. إلى اسم النطاق (مثل *.example.com). إذا لم يكن الحقل متوفّرًا أو كان قائمة فارغة، يكون مشرف تكنولوجيا المعلومات حرًا في استخدام أي اسم نطاق صالح. تكون نطاقات البريد الإلكتروني الشخصية مسموحًا بها دائمًا، ولكن سيؤدي ذلك إلى إنشاء "حسابات Google Play للأعمال".
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من SignupUrl.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidmanagement
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis document describes how to create an enterprise signup URL using an HTTP POST request to \u003ccode\u003ehttps://androidmanagement.googleapis.com/v1/signupUrls\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the Google Cloud project ID, a callback URL for redirection after signup, and optionally, an email address to prefill the admin field.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a \u003ccode\u003eSignupUrl\u003c/code\u003e object containing the generated signup URL.\u003c/p\u003e\n"],["\u003cp\u003eTo use this functionality, you'll need authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This content describes the process of creating an enterprise signup URL via a `POST` request to `https://androidmanagement.googleapis.com/v1/signupUrls`. The request requires a `projectId` and a `callbackUrl`, and optionally an `adminEmail` and `allowedDomains`. The request body must be empty. A successful request returns a `SignupUrl` instance. This requires `https://www.googleapis.com/auth/androidmanagement` authorization scope. After enterprise creation, `enterpriseToken` will be added as a query parameter to the callback URL.\n"],null,["# Method: signupUrls.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an enterprise signup URL.\n\n### HTTP request\n\n`POST https://androidmanagement.googleapis.com/v1/signupUrls`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `projectId` | `string` The ID of the Google Cloud Platform project which will own the enterprise. |\n| `callbackUrl` | `string` The callback URL that the admin will be redirected to after successfully creating an enterprise. Before redirecting there the system will add a query parameter to this URL named `enterpriseToken` which will contain an opaque token to be used for the [create enterprise](/android/management/reference/rest/v1/enterprises/create) request. The URL will be parsed then reformatted in order to add the `enterpriseToken` parameter, so there may be some minor formatting changes. |\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`](/android/management/reference/rest/v1/signupUrls/create#body.QUERY_PARAMETERS.allowed_domains) is non-empty then this must belong to one of the [`allowedDomains`](/android/management/reference/rest/v1/signupUrls/create#body.QUERY_PARAMETERS.allowed_domains). |\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\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [SignupUrl](/android/management/reference/rest/v1/signupUrls#SignupUrl).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
