חשוב: אנחנו לא מקבלים יותר רישומים חדשים עבור Play EMM API.
מידע נוסף
Enterprises: generateSignupUrl
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת כתובת URL להרשמה.
בקשה
בקשת HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
פרמטרים
| שם הפרמטר |
ערך |
תיאור |
| פרמטרים אופציונליים של שאילתות |
adminEmail |
string |
זה שינוי אופציונלי. כתובת האימייל שמשמשת למילוי מראש של השדה 'אדמין' בטופס ההרשמה לארגון. הערך הזה הוא רק רמז והמשתמש יכול לשנות אותו.
אם הערך של allowedDomains לא ריק, הוא חייב להיות שייך לאחד מהערכים של allowedDomains.
|
allowedDomains |
string |
זה שינוי אופציונלי. רשימת הדומיינים שמותר להזין בכתובת האימייל של האדמין. האדמין לא יוכל להזין כתובת אימייל עם שם דומיין שלא מופיע ברשימה הזו. אסור להשתמש בתת-דומיינים של דומיינים שמופיעים ברשימה הזו, אבל אפשר להוסיף רשומה שנייה עם הסיומת *. לפני שם הדומיין (למשל *.example.com) כדי לאפשר את השימוש בהם. אם השדה לא מופיע או שהוא רשימה ריקה, האדמין ב-IT יכול להשתמש בכל שם דומיין תקין. תמיד מותר להשתמש בדומיינים של כתובות אימייל אישיות, אבל הדבר יוביל ליצירה של קבוצת חשבונות Google Play לארגונים.
|
callbackUrl |
string |
כתובת ה-URL לקריאה חוזרת (callback) שאליה האדמין יועבר אחרי שיסיים ליצור את הארגון. לפני ההפניה האוטומטית לכתובת הזו, המערכת תוסיף פרמטר שאילתה יחיד לכתובת ה-URL הזו בשם 'enterpriseToken', שיכיל אסימון אטום שישמש לבקשת CompleteSignup.
חשוב לזכור: המשמעות היא שכתובת ה-URL תפורק, הפרמטר יתווסף ואז כתובת ה-URL החדשה תפורמט. כלומר, יכולים להיות שינויים קלים בפורמט, וחשוב מכך, כתובת ה-URL צריכה להיות בפורמט תקין כדי שניתן יהיה לנתח אותה.
|
אישור
הבקשה הזו דורשת הרשאה ברמת ההיקף הבאה:
| היקף |
|---|
https://www.googleapis.com/auth/androidenterprise |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
אין לספק גוף בקשה בשיטה הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר גוף תגובה עם המבנה הבא:
{
"kind": string,
"url": string,
"completionToken": string
}
| שם הנכס |
ערך |
תיאור |
הערות |
url |
string |
כתובת URL שבאמצעותה האדמין יכול להירשם לארגון. לא ניתן להציג את הדף שמצוין ב-iframe. |
|
completionToken |
string |
אסימון אטום שיידרש, יחד עם אסימון הארגון, כדי לקבל את המשאב הארגוני מ-CompleteSignup. |
|
kind |
string |
הוצא משימוש.
|
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 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. | |"]]
