Ważne: nie przyjmujemy już nowych rejestracji w interfejsie Play EMM API.
Więcej informacji
Enterprises: generateSignupUrl
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Generuje adres URL do rejestracji.
Żądanie
Żądanie HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
Parametry
| Nazwa parametru |
Wartość |
Opis |
| Parametry opcjonalne zapytania |
adminEmail |
string |
Opcjonalnie: Adres e-mail użyty do wstępnego wypełnienia pola administratora w formularzu rejestracji firmy. Ta wartość jest tylko podpowiedzią i może być zmieniana przez użytkownika.
Jeśli lista domen dozwolonych nie jest pusta, musi zawierać jedną z domen z listy domen dozwolonych.
|
allowedDomains |
string |
Opcjonalnie: Lista domen dozwolonych dla adresu e-mail administratora. Administrator IT nie może wpisać adresu e-mail z nazwą domeny, która nie znajduje się na tej liście. Subdomeny domen na tej liście są niedozwolone, ale można je zezwolić, dodając drugi wpis z prefiksem „*.” przed nazwą domeny (np. *.example.com). Jeśli pole jest puste lub nie istnieje, administrator IT może użyć dowolnej prawidłowej nazwy domeny. Domeny poczty e-mail używane do celów osobistych są zawsze dozwolone, ale spowoduje to utworzenie grupy kont zarządzanego Sklepu Google Play.
|
callbackUrl |
string |
Adres URL wywołania zwrotnego, do którego administrator zostanie przekierowany po utworzeniu firmy. Przed przekierowaniem system doda do tego adresu URL parametr zapytania o nazwie „enterpriseToken”, który będzie zawierać nieprzezroczysty token używany do żądania CompleteSignup.
Pamiętaj, że oznacza to, że adres URL zostanie przeanalizowany, dodany parametr i nowy adres URL sformatowany, czyli mogą wystąpić drobne zmiany formatowania. Co ważniejsze, adres URL musi być poprawnie sformatowany, aby można go było przeanalizować.
|
Autoryzacja
To żądanie wymaga autoryzacji z tym zakresem:
| Zakres |
|---|
https://www.googleapis.com/auth/androidenterprise |
Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.
Treść żądania
W przypadku tej metody nie podawaj treści żądania.
Odpowiedź
Jeśli operacja się powiedzie, metoda zwróci odpowiedź o tej strukturze:
{
"kind": string,
"url": string,
"completionToken": string
}
| Nazwa usługi |
Wartość |
Opis |
Uwagi |
url |
string |
Adres URL, pod którym administrator może zarejestrować się w organizacji. Strony, na którą wskazuje element, nie można renderować w elemencie iframe. |
|
completionToken |
string |
Nieprzezroczysty token, który wraz z tokenem dla firm będzie wymagany do uzyskania zasobu dla firm z CompleteSignup. |
|
kind |
string |
Wycofane.
|
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-03-27 UTC.
[null,null,["Ostatnia aktualizacja: 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. | |"]]
