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 للأعمال" كجزء من عملية الترقية هذه القيمة هي تلميح فقط ويمكن للمستخدم تغييرها. لا يُسمح باستخدام عناوين البريد الإلكتروني الشخصية. إذا كانت قيمة allowedDomainsallowedDomains
|
نص الاستجابة
رسالة الرد لإنشاء عنوان URL لترقية "حسابات Google Play للأعمال" الحالية إلى نطاق Google خاضع للإدارة
ملاحظة: هذه الميزة غير متاحة بشكل عام.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"url": string
} |
| الحقول |
url |
string
تمثّل هذه السمة عنوان URL يمكن لمشرف المؤسسة استخدامه لترقية مؤسسته. يتعذّر عرض الصفحة في إطار iframe.
|
نطاقات الأذونات
يجب توفير نطاق 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 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: enterprises.generateEnterpriseUpgradeUrl\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.GenerateEnterpriseUpgradeUrlResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGenerates an enterprise upgrade URL to upgrade an existing managed Google Play Accounts enterprise to a managed Google domain. See [the guide](https://developers.google.com/android/management/upgrade-an-enterprise) for more details.\n\n### HTTP request\n\n`POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the enterprise to be upgraded in the form `enterprises/{enterpriseId}`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------|\n| ``` { \"allowedDomains\": [ string ], \"adminEmail\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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| `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`](/android/management/reference/rest/v1/enterprises/generateEnterpriseUpgradeUrl#body.request_body.FIELDS.allowed_domains) is non-empty then this must belong to one of the [`allowedDomains`](/android/management/reference/rest/v1/enterprises/generateEnterpriseUpgradeUrl#body.request_body.FIELDS.allowed_domains). |\n\n### Response body\n\nResponse message for generating a URL to upgrade an existing managed Google Play Accounts enterprise to a managed Google domain.\n\n**Note:** This feature is not generally available.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------|\n| ``` { \"url\": string } ``` |\n\n| Fields ||\n|-------|--------------------------------------------------------------------------------------------------------------|\n| `url` | `string` A URL for an enterprise admin to upgrade their enterprise. The page can't be rendered in an iframe. |\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)."]]
