Enterprises: generateEnterpriseUpgradeUrl
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menghasilkan URL upgrade perusahaan untuk mengupgrade Akun Google Play perusahaan terkelola yang ada ke Managed Google Domains.
Lihat
panduan mengupgrade perusahaan untuk mengetahui detail selengkapnya.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/generateEnterpriseUpgradeUrl
Parameter
Nama parameter |
Nilai |
Deskripsi |
Parameter jalur |
enterpriseId |
string |
ID perusahaan.
|
Parameter kueri opsional |
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 `allowedDomains` tidak kosong, domain ini harus termasuk dalam salah satu
`allowedDomains`.
|
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 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 merupakan daftar kosong, admin IT bebas menggunakan nama domain yang valid. Domain email
pribadi tidak diizinkan.
|
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut:
Cakupan |
https://www.googleapis.com/auth/androidenterprise |
Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.
Isi permintaan
Jangan berikan isi permintaan dengan metode ini.
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{
"url": string
}
Nama properti |
Nilai |
Deskripsi |
Catatan |
url |
string |
URL untuk admin perusahaan guna mengupgrade perusahaan mereka. Halaman tidak dapat dirender dalam iframe. |
|
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-06-10 UTC.
[null,null,["Terakhir diperbarui pada 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. | |"]]