Enterprises: generateSignupUrl

تنشئ عنوان URL للاشتراك.

الطلب

طلب HTTP

POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات طلب البحث الاختيارية
adminEmail string اختياريّ. عنوان البريد الإلكتروني المستخدَم لملء حقل المشرف في نموذج تسجيل الاشتراك في المؤسسة مسبقًا هذه القيمة هي تلميح فقط ويمكن للمستخدم تغييرها.
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 تمّ إيقاف هذا العمود نهائيًا.