Importante: Ya no aceptamos registros nuevos para la API de EMM de Play.
Más información
Enterprises: generateSignupUrl
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Genera una URL de registro.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
Parámetros
| Nombre del parámetro |
Valor |
Descripción |
| Parámetros de consulta opcionales |
adminEmail |
string |
Opcional. Es la dirección de correo electrónico que se usa para completar previamente el campo de administrador del formulario de registro de la empresa. Este valor es solo una sugerencia y el usuario puede modificarlo.
Si "allowedDomains" no está vacío, debe pertenecer a uno de los "allowedDomains".
|
allowedDomains |
string |
Opcional. Es una lista de dominios permitidos para el correo electrónico del administrador. El administrador de TI no puede ingresar una dirección de correo electrónico con un nombre de dominio que no esté en esta lista. No se permiten subdominios de los dominios de esta lista, pero se pueden permitir si se agrega una segunda entrada que tenga el prefijo "*." al nombre de dominio (p.ej., *.example.com). Si el campo no está presente o es una lista vacía, el administrador de TI puede usar cualquier nombre de dominio válido. Los dominios de correo electrónico personal siempre se permiten, pero se creará una cuenta empresarial de Google Play administrada.
|
callbackUrl |
string |
Es la URL de devolución de llamada a la que se redireccionará al administrador después de crear una empresa de forma correcta. Antes de redireccionar allí, el sistema agregará un solo parámetro de consulta a esta URL llamado "enterpriseToken", que contendrá un token opaco que se usará para la solicitud de CompleteSignup.
Ten en cuenta que esto significa que se analizará la URL, se agregará el parámetro
y, luego, se le asignará un formato de URL nuevo, es decir, es posible que haya algunos cambios de formato
menores y, lo que es más importante, la URL debe tener el formato correcto para que se pueda
analizar.
|
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
| Alcance |
|---|
https://www.googleapis.com/auth/androidenterprise |
Para obtener más información, consulta la página autenticación y autorización.
Cuerpo de la solicitud
No proporciones un cuerpo de la solicitud con este método.
Respuesta
Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:
{
"kind": string,
"url": string,
"completionToken": string
}
| Nombre de la propiedad |
Valor |
Descripción |
Notas |
url |
string |
Es una URL con la que el administrador puede registrarse en una empresa. La página a la que se hace referencia no se puede renderizar en un iframe. |
|
completionToken |
string |
Es un token opaco que se requerirá, junto con el token de la empresa, para obtener el recurso de la empresa de CompleteSignup. |
|
kind |
string |
Obsoleto.
|
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-03-27 (UTC)
[null,null,["Última actualización: 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. | |"]]
