Enterprises: generateSignupUrl
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Membuat URL pendaftaran.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
Parameter
| Nama parameter |
Nilai |
Deskripsi |
| Parameter kueri opsional |
adminEmail |
string |
Opsional. Alamat email yang digunakan untuk mengisi otomatis kolom admin di formulir pendaftaran
perusahaan. Nilai ini hanya berupa petunjuk dan dapat diubah oleh pengguna.
Jika `allowedDomains` tidak kosong, domain ini harus merupakan salah satu dari `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 `*.` di depan nama domain (mis., *.example.com). Jika kolom tidak ada atau merupakan daftar kosong, admin IT bebas menggunakan nama domain yang valid. Domain email
pribadi selalu diizinkan, tetapi akan menghasilkan pembuatan akun Google Play
perusahaan terkelola.
|
callbackUrl |
string |
URL callback tempat Admin akan dialihkan setelah berhasil
membuat perusahaan. Sebelum mengalihkan ke sana, sistem akan menambahkan
satu parameter kueri ke URL ini bernama "enterpriseToken" yang akan
berisi token buram yang akan digunakan untuk permintaan CompleteSignup.
Perlu diketahui bahwa hal ini berarti URL akan diuraikan, parameter ditambahkan,
lalu URL baru diformat, yaitu mungkin ada beberapa perubahan format
kecil dan, yang lebih penting, URL harus dibentuk dengan baik agar dapat
diurai.
|
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:
{
"kind": string,
"url": string,
"completionToken": string
}
| Nama properti |
Nilai |
Deskripsi |
Catatan |
url |
string |
URL tempat Admin dapat mendaftar ke perusahaan. Halaman yang ditunjuk tidak dapat dirender di iframe. |
|
completionToken |
string |
Token buram yang akan diperlukan, bersama dengan Token Perusahaan, untuk mendapatkan resource perusahaan dari CompleteSignup. |
|
kind |
string |
Tidak digunakan lagi.
|
|
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-03-27 UTC.
[null,null,["Terakhir diperbarui pada 2025-03-27 UTC."],[[["\u003cp\u003eGenerates a sign-up URL for Android enterprise enrollment using the \u003ccode\u003esignupUrl\u003c/code\u003e endpoint with an optional admin email and callback URL.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful signup, a response provides a sign-up URL for the admin and a completion token for finalizing the process with the \u003ccode\u003eCompleteSignup\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary to use this endpoint.\u003c/p\u003e\n"]]],[],null,["# Enterprises: generateSignupUrl\n\n| **Note:** Requires [authorization](#auth).\n\nGenerates a sign-up URL.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Optional query parameters** |||\n| `adminEmail` | `string` | Optional. Email address used to prefill the admin field of the enterprise signup form. This value is a hint only and can be altered by the user. 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 always allowed, but will result in the creation of a managed Google Play Accounts enterprise. |\n| `callbackUrl` | `string` | The callback URL to which the Admin will be redirected after successfully creating an enterprise. Before redirecting there the system will add a single query parameter to this URL named \"enterpriseToken\" which will contain an opaque token to be used for the CompleteSignup request. Beware that this means that the URL will be parsed, the parameter added and then a new URL formatted, i.e. there may be some minor formatting changes and, more importantly, the URL must be well-formed so that it can be parsed. |\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 \"kind\": string,\n \"url\": string,\n \"completionToken\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `url` | `string` | A URL under which the Admin can sign up for an enterprise. The page pointed to cannot be rendered in an iframe. | |\n| `completionToken` | `string` | An opaque token that will be required, along with the Enterprise Token, for obtaining the enterprise resource from CompleteSignup. | |\n| `kind` | `string` | Deprecated. | |"]]
