重要提示:我们不再接受 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 中呈现。 |
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-06-10。
[null,null,["最后更新时间 (UTC):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. | |"]]