Важно! Мы больше не принимаем новых регистраций для Play EMM API.
Узнать больше .
Enterprises: generateSignupUrl
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает URL-адрес регистрации.
Запрос
HTTP-запрос
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
Параметры
| Имя параметра | Ценить | Описание |
|---|
| Необязательные параметры запроса |
adminEmail | string | Необязательный. Адрес электронной почты, используемый для предварительного заполнения поля администратора в форме корпоративной регистрации. Это значение является лишь подсказкой и может быть изменено пользователем. Если `allowedDomains` не пусто, то он должен принадлежать одному из `allowedDomains`. |
allowedDomains | string | Необязательный. Список доменов, на которых разрешена адрес электронной почты администратора. ИТ-администратор не может ввести адрес электронной почты с именем домена, которого нет в этом списке. Субдомены доменов в этом списке не разрешены, но их можно разрешить, добавив вторую запись с префиксом `*.` перед именем домена (например, *.example.com). Если поле отсутствует или представляет собой пустой список, ИТ-администратор может использовать любое допустимое доменное имя. Личные домены электронной почты всегда разрешены, но в результате будет создано предприятие с управляемыми учетными записями Google Play. |
callbackUrl | string | URL-адрес обратного вызова, на который будет перенаправлен администратор после успешного создания предприятия. Перед перенаправлением туда система добавит к этому URL-адресу один параметр запроса с именем «enterpriseToken», который будет содержать непрозрачный токен, который будет использоваться для запроса CompleteSignup.
Помните, что это означает, что URL-адрес будет проанализирован, добавлен параметр, а затем отформатирован новый URL-адрес, т. е. могут быть некоторые незначительные изменения форматирования и, что более важно, URL-адрес должен быть правильно сформирован, чтобы его можно было проанализировать. |
Авторизация
Этот запрос требует авторизации со следующей областью действия:
| Объем |
|---|
https://www.googleapis.com/auth/androidenterprise |
Дополнительную информацию см. на странице аутентификации и авторизации .
Тело запроса
Не предоставляйте тело запроса с помощью этого метода.
Ответ
В случае успеха этот метод возвращает тело ответа следующей структуры:
{
"kind": string,
"url": string,
"completionToken": string
}| Имя свойства | Ценить | Описание | Примечания |
|---|
url | string | URL-адрес, по которому администратор может зарегистрироваться в компании. Указанная страница не может быть отображена в iframe. | |
completionToken | string | Непрозрачный токен, который потребуется вместе с токеном предприятия для получения корпоративного ресурса от CompleteSignup. | |
kind | string | Устарело.
| |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-03-27 UTC.
[null,null,["Последнее обновление: 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. | |"]]
