Method: enterprises.generateEnterpriseUpgradeUrl

تنشئ هذه الطريقة عنوان URL لترقية المؤسسة من أجل ترقية مؤسسة "حسابات Google Play للأعمال" الحالية إلى نطاق Google خاضع للإدارة. يمكنك الاطّلاع على الدليل لمزيد من التفاصيل.

طلب HTTP

POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl

يستخدِم عنوان URL بنية تحويل الترميز gRPC.

مَعلمات المسار

المعلمات
name

string

مطلوب. اسم المؤسسة المطلوب ترقيتها في النموذج enterprises/{enterpriseId}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "allowedDomains": [
    string
  ],
  "adminEmail": string
}
الحقول
allowedDomains[]

string

اختيارية: قائمة بالنطاقات المسموح بها لعنوان البريد الإلكتروني للمشرف لا يمكن لمشرف تكنولوجيا المعلومات إدخال عنوان بريد إلكتروني يتضمّن اسم نطاق غير مدرَج في هذه القائمة. لا يُسمح بالنطاقات الفرعية للنطاقات في هذه القائمة، ولكن يمكن السماح بها عن طريق إضافة إدخال ثانٍ يتضمّن *. قبل اسم النطاق (مثل *.example.com). إذا لم يكن الحقل متوفّرًا أو كان عبارة عن قائمة فارغة، يمكن لمشرف تكنولوجيا المعلومات استخدام أي اسم نطاق صالح. لا يُسمح بنطاقات البريد الإلكتروني الشخصية.
adminEmail

string

اختيارية: عنوان البريد الإلكتروني المستخدَم لملء حقل المشرف مسبقًا في نموذج الاشتراك في "حساب Google Play للأعمال" كجزء من عملية الترقية هذه القيمة هي تلميح فقط ويمكن للمستخدم تغييرها. لا يُسمح باستخدام عناوين البريد الإلكتروني الشخصية. إذا كانت قيمة allowedDomains غير فارغة، يجب أن تنتمي إلى إحدى قيم allowedDomains.

نص الاستجابة

رسالة الرد لإنشاء عنوان URL لترقية "حسابات Google Play للأعمال" الحالية إلى نطاق Google خاضع للإدارة

ملاحظة: هذه الميزة غير متاحة بشكل عام.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "url": string
}
الحقول
url

string

تمثّل هذه السمة عنوان URL يمكن لمشرف المؤسسة استخدامه لترقية مؤسسته. يتعذّر عرض الصفحة في إطار iframe.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/androidmanagement

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.