Method: signupUrls.create
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://androidmanagement.googleapis.com/v1/signupUrls
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 |
projectId |
string
擁有企業的 Google Cloud Platform 專案 ID。
|
callbackUrl |
string
管理員成功建立企業後,系統會將其重新導向至這個回呼網址。在重新導向之前,系統會在這個網址中加入名為 enterpriseToken 的查詢參數,其中包含用於建立企業要求的不明確權杖。系統會剖析網址,然後重新格式化,以便新增 enterpriseToken 參數,因此格式可能會略有變動。
|
adminEmail |
string
選用設定。用於在企業註冊表單中預先填入管理員欄位的電子郵件地址。這個值僅是提示,可由使用者變更。如果 allowedDomains 非空白,則必須屬於其中一個 allowedDomains 。
|
allowedDomains[] |
string
選用設定。允許管理員電子郵件使用的網域清單。IT 管理員無法輸入網域名稱不在這個清單中的電子郵件地址。這份清單中的網域子網域不允許使用,但您可以新增第二個項目,在網域名稱前方加上 *. (例如 *.example.com),讓系統允許使用這些子網域。如果這個欄位不存在或清單為空白,IT 管理員可以自由使用任何有效的網域名稱。個人電子郵件網域一律允許使用,但會導致建立 Google Play 管理版帳戶企業。
|
回應主體
如果成功,回應主體會包含新建立的 SignupUrl
例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/androidmanagement
詳情請參閱 OAuth 2.0 Overview。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eThis document describes how to create an enterprise signup URL using an HTTP POST request to \u003ccode\u003ehttps://androidmanagement.googleapis.com/v1/signupUrls\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the Google Cloud project ID, a callback URL for redirection after signup, and optionally, an email address to prefill the admin field.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a \u003ccode\u003eSignupUrl\u003c/code\u003e object containing the generated signup URL.\u003c/p\u003e\n"],["\u003cp\u003eTo use this functionality, you'll need authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This content describes the process of creating an enterprise signup URL via a `POST` request to `https://androidmanagement.googleapis.com/v1/signupUrls`. The request requires a `projectId` and a `callbackUrl`, and optionally an `adminEmail` and `allowedDomains`. The request body must be empty. A successful request returns a `SignupUrl` instance. This requires `https://www.googleapis.com/auth/androidmanagement` authorization scope. After enterprise creation, `enterpriseToken` will be added as a query parameter to the callback URL.\n"],null,["# Method: signupUrls.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an enterprise signup URL.\n\n### HTTP request\n\n`POST https://androidmanagement.googleapis.com/v1/signupUrls`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `projectId` | `string` The ID of the Google Cloud Platform project which will own the enterprise. |\n| `callbackUrl` | `string` The callback URL that the admin will be redirected to after successfully creating an enterprise. Before redirecting there the system will add a query parameter to this URL named `enterpriseToken` which will contain an opaque token to be used for the [create enterprise](/android/management/reference/rest/v1/enterprises/create) request. The URL will be parsed then reformatted in order to add the `enterpriseToken` parameter, so there may be some minor formatting changes. |\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`](/android/management/reference/rest/v1/signupUrls/create#body.QUERY_PARAMETERS.allowed_domains) is non-empty then this must belong to one of the [`allowedDomains`](/android/management/reference/rest/v1/signupUrls/create#body.QUERY_PARAMETERS.allowed_domains). |\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\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [SignupUrl](/android/management/reference/rest/v1/signupUrls#SignupUrl).\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)."]]