مهم: ما دیگر ثبت نام های جدید برای Play EMM API را نمی پذیریم.
بیشتر بدانید .
Enterprises: generateSignupUrl
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
URL ثبت نام را ایجاد می کند.
درخواست کنید
درخواست HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
پارامترها
| نام پارامتر | ارزش | توضیحات |
|---|
| پارامترهای پرس و جو اختیاری |
adminEmail | string | اختیاری. آدرس ایمیل برای پر کردن قسمت مدیریت فرم ثبت نام سازمانی استفاده می شود. این مقدار فقط یک اشاره است و کاربر می تواند آن را تغییر دهد. اگر "allowedDomains" خالی نباشد، باید به یکی از "allowedDomains" تعلق داشته باشد. |
allowedDomains | string | اختیاری. لیستی از دامنه هایی که برای ایمیل مدیریت مجاز هستند. سرپرست فناوری اطلاعات نمی‌تواند آدرس ایمیلی با نام دامنه‌ای که در این لیست نیست وارد کند. دامنه‌های فرعی دامنه‌های موجود در این فهرست مجاز نیستند، اما می‌توان با افزودن یک ورودی دوم که دارای پیشوند «*.» به نام دامنه (مثلا *.example.com) است، مجاز بود. اگر فیلد موجود نباشد یا یک لیست خالی باشد، مدیر فناوری اطلاعات آزاد است که از هر نام دامنه معتبر استفاده کند. دامنه‌های ایمیل شخصی همیشه مجاز هستند، اما منجر به ایجاد یک شرکت مدیریت شده در حساب‌های Google Play می‌شوند. |
callbackUrl | string | URL بازگشت به تماس که مدیر پس از ایجاد موفقیت آمیز یک شرکت به آن هدایت می شود. قبل از هدایت مجدد به آنجا، سیستم یک پارامتر پرس و جوی منفرد را به این URL به نام "enterpriseToken" اضافه می کند که حاوی یک نشانه مات است که برای درخواست CompleteSignup استفاده می شود.
مراقب باشید که این بدان معنی است که URL تجزیه می شود، پارامتر اضافه می شود و سپس یک URL جدید قالب بندی می شود، یعنی ممکن است تغییرات جزئی در قالب وجود داشته باشد و مهمتر از آن، URL باید به خوبی شکل بگیرد تا بتوان آن را تجزیه کرد. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد:
| دامنه |
|---|
https://www.googleapis.com/auth/androidenterprise |
برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{
"kind": string,
"url": string,
"completionToken": string
}| نام ملک | ارزش | توضیحات | یادداشت ها |
|---|
url | string | نشانی اینترنتی که تحت آن مدیر می تواند برای یک شرکت ثبت نام کند. صفحه نشان داده شده در iframe قابل ارائه نیست. | |
completionToken | string | یک توکن غیر شفاف که به همراه توکن Enterprise برای دریافت منبع سازمانی از CompleteSignup مورد نیاز است. | |
kind | string | منسوخ شده است.
| |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشی‌های سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبت‌شده Oracle و/یا شرکت‌های وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-03-27 به‌وقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-03-27 به‌وقت ساعت هماهنگ جهانی."],[[["\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. | |"]]
