Method: signupUrls.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt eine URL für die Registrierung von Unternehmen.
HTTP-Anfrage
POST https://androidmanagement.googleapis.com/v1/signupUrls
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter |
projectId |
string
Die ID des Google Cloud-Projekts, dem das Unternehmen zugewiesen werden soll.
|
callbackUrl |
string
Die Callback-URL, an die der Administrator nach dem erfolgreichen Erstellen eines Unternehmens weitergeleitet wird. Vor der Weiterleitung fügt das System dieser URL einen Abfrageparameter namens enterpriseToken hinzu, der ein undurchsichtiges Token enthält, das für die create enterprise-Anfrage verwendet wird. Die URL wird geparst und dann neu formatiert, um den Parameter enterpriseToken hinzuzufügen. Daher kann es zu geringfügigen Formatierungsänderungen kommen.
|
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. Sie können jedoch zugelassen werden, indem Sie einen zweiten Eintrag hinzufügen, der dem Domainnamen das Präfix *. vorangestellt hat (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.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von SignupUrl
.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidmanagement
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
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-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003eThis document describes how to create an enterprise signup URL using an HTTP POST request to \u003ccode\u003ehttps://androidmanagement.googleapis.com/v1/signupUrls\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the Google Cloud project ID, a callback URL for redirection after signup, and optionally, an email address to prefill the admin field.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a \u003ccode\u003eSignupUrl\u003c/code\u003e object containing the generated signup URL.\u003c/p\u003e\n"],["\u003cp\u003eTo use this functionality, you'll need authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This content describes the process of creating an enterprise signup URL via a `POST` request to `https://androidmanagement.googleapis.com/v1/signupUrls`. The request requires a `projectId` and a `callbackUrl`, and optionally an `adminEmail` and `allowedDomains`. The request body must be empty. A successful request returns a `SignupUrl` instance. This requires `https://www.googleapis.com/auth/androidmanagement` authorization scope. After enterprise creation, `enterpriseToken` will be added as a query parameter to the callback URL.\n"],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an enterprise signup URL.\n\nHTTP request\n\n`POST https://androidmanagement.googleapis.com/v1/signupUrls`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nQuery parameters\n\n| Parameters ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `projectId` | `string` The ID of the Google Cloud Platform project which will own the enterprise. |\n| `callbackUrl` | `string` The callback URL that the admin will be redirected to after successfully creating an enterprise. Before redirecting there the system will add a query parameter to this URL named `enterpriseToken` which will contain an opaque token to be used for the [create enterprise](/android/management/reference/rest/v1/enterprises/create) request. The URL will be parsed then reformatted in order to add the `enterpriseToken` parameter, so there may be some minor formatting changes. |\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`](/android/management/reference/rest/v1/signupUrls/create#body.QUERY_PARAMETERS.allowed_domains) is non-empty then this must belong to one of the [`allowedDomains`](/android/management/reference/rest/v1/signupUrls/create#body.QUERY_PARAMETERS.allowed_domains). |\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\nRequest body\n\nThe request body must be empty.\n\nResponse body\n\nIf successful, the response body contains a newly created instance of [SignupUrl](/android/management/reference/rest/v1/signupUrls#SignupUrl).\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]