Method: enterprises.generateEnterpriseUpgradeUrl
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Génère une URL de mise à niveau d'entreprise pour mettre à niveau un compte d'entreprise Google Play Accounts existant vers un domaine Google géré. Pour en savoir plus, consultez ce guide.
Requête HTTP
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
name |
string
Obligatoire. Nom de l'entreprise à mettre à niveau au format enterprises/{enterpriseId}.
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
{
"allowedDomains": [
string
],
"adminEmail": string
} |
| Champs |
allowedDomains[] |
string
Facultatif. Liste des domaines autorisés pour l'adresse e-mail de l'administrateur. L'administrateur informatique ne peut pas saisir d'adresse e-mail dont le nom de domaine ne figure pas dans cette liste. Les sous-domaines des domaines figurant dans cette liste ne sont pas autorisés, mais peuvent l'être en ajoutant une deuxième entrée avec le préfixe *. devant le nom de domaine (par exemple, *.example.com). Si le champ n'est pas présent ou s'il s'agit d'une liste vide, l'administrateur informatique est libre d'utiliser n'importe quel nom de domaine valide. Les domaines d'adresse e-mail personnels ne sont pas autorisés.
|
adminEmail |
string
Facultatif. Adresse e-mail utilisée pour préremplir le champ "Administrateur" du formulaire d'inscription à l'édition Enterprise lors du processus de mise à niveau. Cette valeur n'est qu'une indication et peut être modifiée par l'utilisateur. Les adresses e-mail personnelles ne sont pas autorisées. Si allowedDomainsallowedDomains
|
Corps de la réponse
Message de réponse pour générer une URL permettant de migrer un compte d'entreprise Google Play Accounts existant vers un domaine Google géré.
Remarque : Cette fonctionnalité n'est pas disponible pour tous les utilisateurs.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"url": string
} |
| Champs |
url |
string
URL permettant à un administrateur Enterprise de mettre à niveau son entreprise. La page ne peut pas être affichée dans un iFrame.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/androidmanagement
Pour en savoir plus, consultez OAuth 2.0 Overview.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
