ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM).
مزيد من المعلومات
Enterprises: generateEnterpriseUpgradeUrl
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إنشاء عنوان URL لترقية المؤسسة من أجل ترقية "حسابات Google Play للأعمال" الحالية إلى نطاق Google خاضع للإدارة
اطّلِع على
دليل ترقية مؤسسة للحصول على مزيد من التفاصيل.
الطلب
طلب HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/generateEnterpriseUpgradeUrl
المعلمات
اسم المعلَمة |
القيمة |
الوصف |
مَعلمات المسار |
enterpriseId |
string |
رقم تعريف المؤسسة.
|
مَعلمات طلب البحث الاختيارية |
adminEmail |
string |
اختياريّ. عنوان البريد الإلكتروني المستخدَم لملء حقل المشرف في نموذج تسجيل الاشتراك في "حسابات Google Play للأعمال" مسبقًا كجزء من عملية الترقية هذه القيمة هي تلميح فقط ويمكن
للمستخدم تغييرها. لا يُسمح بعناوين البريد الإلكتروني الشخصية.
إذا كانت قيمة allowedDomains غير فارغة، يجب أن تنتمي إلى أحد
allowedDomains.
|
allowedDomains |
string |
اختياريّ. قائمة بالنطاقات المسموح بها لعنوان البريد الإلكتروني الخاص بالمشرف لا يمكن لمشرف تكنولوجيا المعلومات إدخال عنوان بريد إلكتروني يحتوي على اسم نطاق غير مُدرَج في
هذه القائمة.
لا يُسمح بالنطاقات الفرعية للنطاقات المدرَجة في هذه القائمة، ولكن يمكن
السماح بها من خلال إضافة إدخال ثانٍ يتضمّن البادئة "*." إلى اسم
النطاق (مثل *.example.com). إذا لم يكن الحقل متوفّرًا أو كان ملفًا شخصيًا فارغًا، يمكن لمشرف تكنولوجيا المعلومات استخدام أي اسم نطاق صالح. لا يُسمح بنطاقات البريد الإلكتروني
الشخصية.
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
النطاق |
https://www.googleapis.com/auth/androidenterprise |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
لا تقدِّم محتوى طلب باستخدام هذه الطريقة.
الردّ
في حال نجاح هذه الطريقة، تعرض نص استجابة بالبنية التالية:
{
"url": string
}
اسم السمة |
القيمة |
الوصف |
ملاحظات |
url |
string |
عنوان URL يتيح لمشرف المؤسسة ترقية مؤسسته لا يمكن عرض الصفحة في إطار iframe. |
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-06-10 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-06-10 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Enterprises: generateEnterpriseUpgradeUrl\n\n| **Note:** Requires [authorization](#auth).\n\nGenerates an enterprise upgrade URL to upgrade an existing managed Google\nPlay Accounts enterprise to a managed Google domain.\nSee [the guide to upgrading an enterprise](/android/work/play/emm-api/upgrade-an-enterprise) for more details.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/generateEnterpriseUpgradeUrl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| **Optional query parameters** |||\n| `adminEmail` | `string` | Optional. Email address used to prefill the admin field of the enterprise signup form as part of the upgrade process. This value is a hint only and can be altered by the user. Personal email addresses are not allowed. 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 not allowed. |\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 \"url\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------|-------|\n| `url` | `string` | A URL for an enterprise admin to upgrade their enterprise. The page can't be rendered in an iframe. | |"]]