Importante: não aceitamos mais novos registros para a API Play EMM.
Saiba mais.
Enterprises: generateEnterpriseUpgradeUrl
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Gera um URL de upgrade empresarial para fazer upgrade de um pacote de contas do Google Play gerenciado para um Managed Google Domain.
Consulte o
guia de upgrade de uma empresa para mais detalhes.
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/generateEnterpriseUpgradeUrl
Parâmetros
| Nome do parâmetro |
Valor |
Descrição |
| Parâmetros de caminho |
enterpriseId |
string |
O ID da empresa.
|
| Parâmetros de consulta opcionais |
adminEmail |
string |
Opcional. Endereço de e-mail usado para preencher previamente o campo de administrador do formulário de inscrição
empresarial como parte do processo de upgrade. Esse valor é apenas uma sugestão e
pode ser alterado pelo usuário. Endereços de e-mail pessoais não são permitidos.
Se "allowedDomains" não estiver vazio, ele precisará pertencer a um dos
"allowedDomains".
|
allowedDomains |
string |
Opcional. Uma lista de domínios permitidos para o e-mail do administrador. O administrador de TI
não pode inserir um endereço de e-mail com um nome de domínio que não está
nesta lista.
Os subdomínios dos domínios dessa lista não são permitidos, mas podem ser
adicionados ao adicionar uma segunda entrada com o prefixo "*." ao nome do
domínio (por exemplo, *.example.com). Se o campo não estiver presente ou for uma lista
vazia, o administrador de TI poderá usar qualquer nome de domínio válido. Domínios de e-mail
pessoais não são permitidos.
|
Autorização
Esta solicitação requer autorização com o seguinte escopo:
| Escopo |
|---|
https://www.googleapis.com/auth/androidenterprise |
Para mais informações, consulte a página de autenticação e autorização.
Corpo da solicitação
Não forneça um corpo de solicitação com este método.
Resposta
Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:
{
"url": string
}
| Nome da propriedade |
Valor |
Descrição |
Observações |
url |
string |
Um URL para um administrador corporativo fazer upgrade da empresa. A página não pode ser renderizada em um iframe. |
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-06-10 UTC.
[null,null,["Última atualização 2025-06-10 UTC."],[],[],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. | |"]]
