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	تم إيقاف هذا العمود نهائيًا.