重要資訊:我們目前不接受新的 Play EMM API 註冊。
瞭解詳情。
Enterprises: generateEnterpriseUpgradeUrl
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
產生企業升級網址,將現有的 Google Play 管理版帳戶企業升級為 Google 管理版網域。詳情請參閱
升級企業的操作指南。
要求
HTTP 要求
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/generateEnterpriseUpgradeUrl
參數
參數名稱 |
值 |
說明 |
路徑參數 |
enterpriseId |
string |
企業 ID。
|
選用查詢參數 |
adminEmail |
string |
(選用步驟) 在升級程序中,這個電子郵件地址會用於預先填入企業註冊表單的管理員欄位。這個值僅供參考,可由使用者變更。請勿使用個人電子郵件地址。如果 `allowedDomains` 非空白,則此值必須屬於其中一個 `allowedDomains`。 |
allowedDomains |
string |
(選用步驟) 允許管理員電子郵件使用的網域清單。IT 管理員無法輸入網域名稱不在這個清單中的電子郵件地址。系統不允許使用這份清單中的網域子網域,但您可以新增第二個項目,在網域名稱前方加上「*.」前置字元 (例如 *.example.com),即可允許使用這些網域。如果沒有這個欄位,或是清單為空白,IT 管理員可以自由使用任何有效的網域名稱。不允許使用個人電子郵件網域。 |
授權
這項要求需要下列範圍的授權:
範圍 |
https://www.googleapis.com/auth/androidenterprise |
詳情請參閱「驗證與授權」頁面。
要求主體
請勿透過此方法提供要求主體。
回應
如果成功的話,這個方法會傳回回應內文,其結構如下:
{
"url": string
}
屬性名稱 |
值 |
說明 |
附註 |
url |
string |
企業管理員升級企業的網址。無法在 iframe 中轉譯網頁。 |
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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. | |"]]