Enterprises: generateSignupUrl
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Generiert eine Registrierungs-URL.
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
Parameter
| Parametername |
Wert |
Beschreibung |
| Optionale Suchparameter |
adminEmail |
string |
Optional. E-Mail-Adresse, mit der das Administratorfeld im Registrierungsformular für Unternehmen vorab ausgefüllt wird. Dieser Wert ist nur ein Hinweis und kann vom Nutzer geändert werden.
Wenn „allowedDomains“ nicht leer ist, muss es zu einer der „allowedDomains“ gehören.
|
allowedDomains |
string |
Optional. Eine Liste der Domains, die für die Administrator-E-Mail-Adresse zulässig sind. Der IT-Administrator kann keine E-Mail-Adresse mit einem Domainnamen eingeben, der nicht in dieser Liste enthalten ist. Subdomains von Domains in dieser Liste sind nicht zulässig, können aber zugelassen werden, indem ein zweiter Eintrag mit dem Präfix „*.“ vor dem Domainnamen hinzugefügt wird (z.B. *.beispiel.de). Wenn das Feld nicht vorhanden ist oder eine leere Liste ist, kann der IT-Administrator jeden gültigen Domainnamen verwenden. Private E-Mail-Domains sind immer zulässig, führen aber zur Erstellung einer Kontogruppe für Managed Google Play.
|
callbackUrl |
string |
Die Callback-URL, an die der Administrator nach dem Erstellen eines Unternehmens weitergeleitet wird. Bevor die Weiterleitung erfolgt, fügt das System dieser URL einen einzelnen Suchparameter namens „enterpriseToken“ hinzu, der ein undurchsichtiges Token enthält, das für die CompleteSignup-Anfrage verwendet wird.
Beachten Sie, dass die URL geparst, der Parameter hinzugefügt und dann eine neue URL formatiert wird.Es kann also zu geringfügigen Formatierungsänderungen kommen. Wichtiger ist jedoch, dass die URL korrekt formatiert ist, damit sie geparst werden kann.
|
Autorisierung
Für diese Anfrage ist eine Autorisierung mit dem folgenden Umfang erforderlich:
| Umfang |
|---|
https://www.googleapis.com/auth/androidenterprise |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{
"kind": string,
"url": string,
"completionToken": string
}
| Name der Eigenschaft |
Wert |
Beschreibung |
Hinweise |
url |
string |
Eine URL, unter der sich der Administrator für ein Unternehmen registrieren kann. Die Seite, auf die verwiesen wird, kann nicht in einem iFrame gerendert werden. |
|
completionToken |
string |
Ein opakes Token, das zusammen mit dem Enterprise-Token erforderlich ist, um die Unternehmensressource von CompleteSignup abzurufen. |
|
kind |
string |
Veraltet.
|
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-03-27 (UTC).
[null,null,["Zuletzt aktualisiert: 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. | |"]]
