Method: enterprises.generateEnterpriseUpgradeUrl
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Genera un URL di upgrade dell'azienda per eseguire l'upgrade di un'azienda con account Google Play gestiti esistente a un dominio Google gestito. Per saperne di più, consulta la guida.
Richiesta HTTP
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
name |
string
Obbligatorio. Il nome dell'impresa da aggiornare nel formato enterprises/{enterpriseId}.
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"allowedDomains": [
string
],
"adminEmail": string
} |
| Campi |
allowedDomains[] |
string
(Facoltativo) Un elenco di domini consentiti per l'email dell'amministratore. L'amministratore IT non può inserire un indirizzo email con un nome di dominio che non è presente in questo elenco. I sottodomini dei domini in questo elenco non sono consentiti, ma possono essere autorizzati aggiungendo una seconda voce con *. come prefisso del nome di dominio (ad es. *.example.com). Se il campo non è presente o è un elenco vuoto, l'amministratore IT è libero di utilizzare qualsiasi nome di dominio valido. Non sono consentiti domini email personali.
|
adminEmail |
string
(Facoltativo) Indirizzo email utilizzato per precompilare il campo amministratore del modulo di registrazione aziendale nell'ambito della procedura di upgrade. Questo valore è solo un suggerimento e può essere modificato dall'utente. Non sono consentiti indirizzi email personali. Se allowedDomainsallowedDomains
|
Corpo della risposta
Messaggio di risposta per la generazione di un URL per eseguire l'upgrade di un'azienda con account Google Play gestiti esistente a un dominio Google gestito.
Nota:questa funzionalità non è disponibile a livello generale.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"url": string
} |
| Campi |
url |
string
Un URL per consentire a un amministratore aziendale di eseguire l'upgrade della propria azienda. La pagina non può essere visualizzata in un iframe.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidmanagement
Per ulteriori informazioni, consulta la OAuth 2.0 Overview.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
