Enterprises: generateSignupUrl
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
สร้าง URL การลงชื่อสมัครใช้
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
พารามิเตอร์
| ชื่อพารามิเตอร์ |
ค่า |
คำอธิบาย |
| พารามิเตอร์การค้นหาที่ไม่บังคับ |
adminEmail |
string |
ไม่บังคับ อีเมลที่ใช้ป้อนข้อมูลในช่องผู้ดูแลระบบของแบบฟอร์มการลงชื่อสมัครใช้ขององค์กรล่วงหน้า ค่านี้เป็นคำแนะนำเท่านั้นและผู้ใช้สามารถแก้ไขได้
หาก `allowedDomains` ไม่ได้ว่างเปล่า โดเมนนี้ต้องอยู่ใน `allowedDomains`
|
allowedDomains |
string |
ไม่บังคับ รายการโดเมนที่อนุญาตสำหรับอีเมลผู้ดูแลระบบ ผู้ดูแลระบบไอทีจะป้อนอีเมลที่มีชื่อโดเมนซึ่งไม่อยู่ในรายการนี้ไม่ได้ ระบบไม่อนุญาตให้ใช้โดเมนย่อยของโดเมนในรายการนี้ แต่สามารถอนุญาตได้โดยเพิ่มรายการที่ 2 ซึ่งมี "*." นำหน้าชื่อโดเมน (เช่น *.example.com) หากไม่มีช่องนี้หรือเป็นรายการว่างเปล่า ผู้ดูแลระบบไอทีจะใช้ชื่อโดเมนใดก็ได้ที่ถูกต้อง ระบบจะอนุญาตโดเมนอีเมลส่วนตัวเสมอ แต่จะเป็นการสร้างกลุ่มบัญชี Managed Google Play สำหรับองค์กร
|
callbackUrl |
string |
URL การเรียกกลับที่ระบบจะเปลี่ยนเส้นทางผู้ดูแลระบบไปหลังจากสร้างองค์กรเรียบร้อยแล้ว ก่อนที่จะเปลี่ยนเส้นทางไปยัง URL ดังกล่าว ระบบจะเพิ่มพารามิเตอร์การค้นหารายการเดียวลงใน URL นี้ชื่อ "enterpriseToken" ซึ่งจะมีโทเค็นแบบทึบใช้สำหรับคำขอ CompleteSignup
โปรดทราบว่าการดำเนินการนี้หมายความว่าระบบจะแยกวิเคราะห์ URL, เพิ่มพารามิเตอร์ แล้วจัดรูปแบบ URL ใหม่ กล่าวคืออาจมีการเปลี่ยนแปลงการจัดรูปแบบเล็กน้อย และที่สำคัญคือ URL ต้องอยู่ในรูปแบบที่ถูกต้องจึงจะแยกวิเคราะห์ได้
|
การให้สิทธิ์
คำขอนี้ต้องได้รับสิทธิ์ที่มีขอบเขตต่อไปนี้
| ขอบเขต |
|---|
https://www.googleapis.com/auth/androidenterprise |
ดูข้อมูลเพิ่มเติมได้ที่หน้าการตรวจสอบสิทธิ์และการให้สิทธิ์
เนื้อหาของคำขอ
อย่าระบุเนื้อหาคำขอด้วยเมธอดนี้
การตอบกลับ
หากทำสำเร็จ วิธีการนี้จะแสดงผลลัพธ์เป็นเนื้อหาการตอบกลับซึ่งมีโครงสร้างดังต่อไปนี้
{
"kind": string,
"url": string,
"completionToken": string
}
| ชื่อพร็อพเพอร์ตี้ |
ค่า |
คำอธิบาย |
หมายเหตุ |
url |
string |
URL ที่ผู้ดูแลระบบลงชื่อสมัครใช้องค์กรได้ หน้าเว็บที่ชี้ไปไม่สามารถแสดงผลใน iframe ได้ |
|
completionToken |
string |
โทเค็นแบบทึบแสงซึ่งต้องใช้ควบคู่ไปกับโทเค็นขององค์กรเพื่อรับทรัพยากรขององค์กรจาก CompleteSignup |
|
kind |
string |
เลิกใช้งานแล้ว
|
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-03-27 UTC
[null,null,["อัปเดตล่าสุด 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. | |"]]
