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, um eine vorhandene Kontogruppe für Managed Google Play auf eine verwaltete Google-Domain umzustellen.
Weitere Informationen finden Sie im
Leitfaden zum Upgrade eines Unternehmens.
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/generateEnterpriseUpgradeUrl
Parameter
| Parametername |
Wert |
Beschreibung |
| Pfadparameter |
enterpriseId |
string |
Die ID des Unternehmens.
|
| Optionale Suchparameter |
adminEmail |
string |
Optional. E-Mail-Adresse, mit der das Administratorfeld des Registrierungsformulars für Unternehmen im Rahmen des Upgrades vorab ausgefüllt wurde. Dieser Wert ist nur ein Hinweis und kann vom Nutzer geändert werden. Private E-Mail-Adressen sind nicht zulässig.
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 enthält, kann der IT-Administrator jeden gültigen Domainnamen verwenden. Private E-Mail-Domains sind nicht zulässig.
|
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:
{
"url": string
}
| Name der Eigenschaft |
Wert |
Beschreibung |
Hinweise |
url |
string |
Eine URL, über die ein Enterprise-Administrator ein Upgrade für sein Unternehmen durchführen kann. Die Seite kann nicht in einem iFrame gerendert werden. |
|
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-06-10 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-06-10 (UTC)."],[],[],null,["# Enterprises: generateEnterpriseUpgradeUrl\n\n| **Note:** Requires [authorization](#auth).\n\nGenerates an enterprise upgrade URL to upgrade an existing managed Google\nPlay Accounts enterprise to a managed Google domain.\nSee [the guide to upgrading an enterprise](/android/work/play/emm-api/upgrade-an-enterprise) for more details.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/generateEnterpriseUpgradeUrl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| **Optional query parameters** |||\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\\` 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 not allowed. |\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 \"url\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------|-------|\n| `url` | `string` | A URL for an enterprise admin to upgrade their enterprise. The page can't be rendered in an iframe. | |"]]
