Lưu ý quan trọng: Chúng tôi không còn chấp nhận các lượt đăng ký mới cho Play EMM API.
Tìm hiểu thêm.
Enterprises: generateSignupUrl
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tạo URL đăng ký.
Yêu cầu
Yêu cầu HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
Thông số
| Tên thông số |
Giá trị |
Mô tả |
| Thông số truy vấn không bắt buộc |
adminEmail |
string |
Không bắt buộc. Địa chỉ email dùng để điền sẵn trường quản trị của biểu mẫu đăng ký dành cho doanh nghiệp. Giá trị này chỉ là gợi ý và người dùng có thể thay đổi.
Nếu `allowedDomains` không trống thì giá trị này phải thuộc một trong các `allowedDomains`.
|
allowedDomains |
string |
Không bắt buộc. Danh sách các miền được phép cho email quản trị. Quản trị viên CNTT không thể nhập địa chỉ email có tên miền không có trong danh sách này. Miền con của các miền trong danh sách này không được phép, nhưng bạn có thể thêm một mục nhập thứ hai có tiền tố "*." vào tên miền (ví dụ: *.example.com). Nếu trường này không xuất hiện hoặc là danh sách trống, thì quản trị viên CNTT có thể sử dụng bất kỳ tên miền hợp lệ nào. Miền email cá nhân luôn được cho phép, nhưng sẽ dẫn đến việc tạo một tập hợp Tài khoản Google Play có quản lý.
|
callbackUrl |
string |
URL gọi lại mà Quản trị viên sẽ được chuyển hướng đến sau khi tạo thành công một doanh nghiệp. Trước khi chuyển hướng đến đó, hệ thống sẽ thêm một tham số truy vấn duy nhất vào URL này có tên là "enterpriseToken". Tham số này sẽ chứa một mã thông báo mờ để sử dụng cho yêu cầu CompleteSignup.
Xin lưu ý rằng điều này có nghĩa là URL sẽ được phân tích cú pháp, tham số được thêm vào
rồi định dạng URL mới, tức là có thể có một số thay đổi nhỏ về định dạng
và quan trọng hơn, URL phải được định dạng đúng cách để có thể
phân tích cú pháp.
|
Ủy quyền
Yêu cầu này yêu cầu uỷ quyền với phạm vi sau:
| Phạm vi |
|---|
https://www.googleapis.com/auth/androidenterprise |
Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.
Nội dung yêu cầu
Không cung cấp nội dung yêu cầu bằng phương thức này.
Phản hồi
Nếu thành công, phương thức này sẽ trả về một phần nội dung phản hồi có cấu trúc sau:
{
"kind": string,
"url": string,
"completionToken": string
}
| Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
url |
string |
URL mà Quản trị viên có thể dùng để đăng ký cho một doanh nghiệp. Không thể hiển thị trang được trỏ đến trong iframe. |
|
completionToken |
string |
Bạn sẽ cần một mã thông báo mờ cùng với Mã thông báo doanh nghiệp để lấy tài nguyên doanh nghiệp từ CompleteSignup. |
|
kind |
string |
Không dùng nữa.
|
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-03-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. | |"]]
