Method: enterprises.generateEnterpriseUpgradeUrl
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
產生企業升級網址,將現有的 Google Play 管理版帳戶企業升級為受管理 Google 網域。詳情請參閱這份指南。
HTTP 要求
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
name |
string
必要欄位。要升級的企業名稱,格式為 enterprises/{enterpriseId} 。
|
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
{
"allowedDomains": [
string
],
"adminEmail": string
} |
欄位 |
allowedDomains[] |
string
(選用步驟) 允許管理員電子郵件使用的網域清單。IT 管理員無法輸入不在這個清單中的網域名稱。清單中網域的子網域不允許,但可以新增第二個項目,並在網域名稱前加上 *. (例如 *.example.com),即可允許子網域。如果沒有這個欄位或欄位為空白清單,IT 管理員可以自由使用任何有效網域名稱。不允許使用個人電子郵件網域。
|
adminEmail |
string
(選用步驟) 在升級程序中,系統會使用這個電子郵件地址預先填入企業註冊表單的管理員欄位。這個值僅供參考,使用者可以變更。請勿使用個人電子郵件地址。如果 allowedDomains 不為空,則必須屬於其中一個 allowedDomains 。
|
回應主體
產生網址的回應訊息,可將現有的 Google Play 管理版帳戶企業升級為受管理 Google 網域。
注意:這項功能並未正式發布。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
{
"url": string
} |
欄位 |
url |
string
企業管理員用來升級企業的網址。該網頁無法在 iframe 中顯示。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/androidmanagement
詳情請參閱OAuth 2.0 Overview。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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)."]]