Method: enterprises.generateEnterpriseUpgradeUrl
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Generiert eine Upgrade-URL für Unternehmen, mit der eine vorhandene Kontogruppe für Managed Google Play auf eine verwaltete Google-Domain umgestellt werden kann. Weitere Informationen
HTTP-Anfrage
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Erforderlich. Der Name des Unternehmens, das aktualisiert werden soll, im Format enterprises/{enterpriseId}.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"allowedDomains": [
string
],
"adminEmail": string
} |
| Felder |
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 Sie einen zweiten Eintrag hinzufügen, dem *. vorangestellt ist (z.B. *.beispiel.de). Wenn das Feld nicht vorhanden oder eine leere Liste ist, kann der IT-Administrator einen beliebigen gültigen Domainnamen verwenden. Private E-Mail-Domains sind nicht zulässig.
|
adminEmail |
string
Optional. E-Mail-Adresse, die zum Vorausfüllen des Administratorfelds des Registrierungsformulars für Unternehmen im Rahmen des Upgrades verwendet wird. Dieser Wert ist nur ein Hinweis und kann vom Nutzer geändert werden. Private E-Mail-Adressen sind nicht zulässig. Wenn allowedDomainsallowedDomains
|
Antworttext
Antwortnachricht zum Generieren einer URL für das Upgrade einer vorhandenen Kontogruppe für Managed Google Play auf eine verwaltete Google-Domain.
Hinweis:Diese Funktion ist nicht allgemein verfügbar.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"url": string
} |
| Felder |
url |
string
Eine URL für einen Unternehmensadministrator, um ein Upgrade für sein Unternehmen durchzuführen. Die Seite kann nicht in einem iFrame gerendert werden.
|
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)."],[],[],null,["# Method: enterprises.generateEnterpriseUpgradeUrl\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.GenerateEnterpriseUpgradeUrlResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGenerates an enterprise upgrade URL to upgrade an existing managed Google Play Accounts enterprise to a managed Google domain. See [the guide](https://developers.google.com/android/management/upgrade-an-enterprise) for more details.\n\n### HTTP request\n\n`POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the enterprise to be upgraded in the form `enterprises/{enterpriseId}`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------|\n| ``` { \"allowedDomains\": [ string ], \"adminEmail\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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 not allowed. |\n| `adminEmail` | `string` Optional. Email address used to prefill the admin field of the enterprise signup form as part of the upgrade process. This value is a hint only and can be altered by the user. Personal email addresses are not allowed. If [`allowedDomains`](/android/management/reference/rest/v1/enterprises/generateEnterpriseUpgradeUrl#body.request_body.FIELDS.allowed_domains) is non-empty then this must belong to one of the [`allowedDomains`](/android/management/reference/rest/v1/enterprises/generateEnterpriseUpgradeUrl#body.request_body.FIELDS.allowed_domains). |\n\n### Response body\n\nResponse message for generating a URL to upgrade an existing managed Google Play Accounts enterprise to a managed Google domain.\n\n**Note:** This feature is not generally available.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------|\n| ``` { \"url\": string } ``` |\n\n| Fields ||\n|-------|--------------------------------------------------------------------------------------------------------------|\n| `url` | `string` A URL for an enterprise admin to upgrade their enterprise. The page can't be rendered in an iframe. |\n\n### Authorization 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)."]]
