Method: enterprises.generateEnterpriseUpgradeUrl
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Membuat URL upgrade perusahaan untuk mengupgrade akun Google Play perusahaan terkelola yang sudah ada ke Managed Google Domains. Lihat panduan untuk mengetahui detail selengkapnya.
Permintaan HTTP
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
name |
string
Wajib. Nama perusahaan yang akan diupgrade dalam bentuk enterprises/{enterpriseId}.
|
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
| Representasi JSON |
{
"allowedDomains": [
string
],
"adminEmail": string
} |
| Kolom |
allowedDomains[] |
string
Opsional. Daftar domain yang diizinkan untuk email admin. Admin IT tidak dapat memasukkan alamat email dengan nama domain yang tidak ada dalam daftar ini. Subdomain dari domain dalam daftar ini tidak diizinkan, tetapi dapat diizinkan dengan menambahkan entri kedua yang memiliki awalan *. pada nama domain (misalnya, *.example.com). Jika kolom tidak ada atau berupa daftar kosong, admin IT bebas menggunakan nama domain yang valid. Domain email pribadi tidak diizinkan.
|
adminEmail |
string
Opsional. Alamat email yang digunakan untuk mengisi otomatis kolom admin pada formulir pendaftaran perusahaan sebagai bagian dari proses upgrade. Nilai ini hanya berupa petunjuk dan dapat diubah oleh pengguna. Alamat email pribadi tidak diizinkan. Jika allowedDomainsallowedDomains
|
Isi respons
Pesan respons untuk membuat URL guna mengupgrade akun Google Play perusahaan terkelola yang sudah ada ke Managed Google Domains.
Catatan: Fitur ini tidak tersedia secara umum.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"url": string
} |
| Kolom |
url |
string
URL bagi admin perusahaan untuk mengupgrade perusahaan mereka. Halaman tidak dapat dirender dalam iframe.
|
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/androidmanagement
Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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)."]]
