Importante: não aceitamos mais novos registros para a API Play EMM.
Saiba mais.
Enterprises: generateSignupUrl
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Gera um URL de inscrição.
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
Parâmetros
| Nome do parâmetro |
Valor |
Descrição |
| 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
para empresas. Esse valor é apenas uma sugestão e pode ser alterado pelo usuário.
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 esteja
nesta lista. Os subdomínios dos domínios dessa lista não são permitidos, mas podem ser
adicionados adicionando 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. Os domínios de e-mail
pessoais são sempre permitidos, mas resultam na criação de um pacote
de contas do Google Play gerenciado.
|
callbackUrl |
string |
O URL de callback para o qual o administrador será redirecionado após a criação de uma empresa. Antes de redirecionar, o sistema vai adicionar um
parâmetro de consulta único a esse URL chamado "enterpriseToken", que vai
conter um token opaco a ser usado para a solicitação de "CompleteSignup".
Isso significa que o URL será analisado, o parâmetro será adicionado
e um novo URL será formatado. Ou seja, pode haver algumas pequenas mudanças
na formatação e, mais importante, o URL precisa estar bem formatado para que possa
ser analisado.
|
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:
{
"kind": string,
"url": string,
"completionToken": string
}
| Nome da propriedade |
Valor |
Descrição |
Observações |
url |
string |
Um URL em que o administrador pode se inscrever para uma empresa. A página apontada não pode ser renderizada em um iframe. |
|
completionToken |
string |
Um token opaco que será necessário, junto com o token empresarial, para receber o recurso empresarial do CompleteSignup. |
|
kind |
string |
Descontinuado.
|
|
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-03-27 UTC.
[null,null,["Última atualização 2025-03-27 UTC."],[[["\u003cp\u003eGenerates a sign-up URL for Android enterprise enrollment using the \u003ccode\u003esignupUrl\u003c/code\u003e endpoint with an optional admin email and callback URL.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful signup, a response provides a sign-up URL for the admin and a completion token for finalizing the process with the \u003ccode\u003eCompleteSignup\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary to use this endpoint.\u003c/p\u003e\n"]]],[],null,["# Enterprises: generateSignupUrl\n\n| **Note:** Requires [authorization](#auth).\n\nGenerates a sign-up URL.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Optional query parameters** |||\n| `adminEmail` | `string` | Optional. Email address used to prefill the admin field of the enterprise signup form. This value is a hint only and can be altered by the user. 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 always allowed, but will result in the creation of a managed Google Play Accounts enterprise. |\n| `callbackUrl` | `string` | The callback URL to which the Admin will be redirected after successfully creating an enterprise. Before redirecting there the system will add a single query parameter to this URL named \"enterpriseToken\" which will contain an opaque token to be used for the CompleteSignup request. Beware that this means that the URL will be parsed, the parameter added and then a new URL formatted, i.e. there may be some minor formatting changes and, more importantly, the URL must be well-formed so that it can be parsed. |\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 \"kind\": string,\n \"url\": string,\n \"completionToken\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `url` | `string` | A URL under which the Admin can sign up for an enterprise. The page pointed to cannot be rendered in an iframe. | |\n| `completionToken` | `string` | An opaque token that will be required, along with the Enterprise Token, for obtaining the enterprise resource from CompleteSignup. | |\n| `kind` | `string` | Deprecated. | |"]]
