יצירת כתובת 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 |
הוצא משימוש. |