Method: enterprises.generateEnterpriseUpgradeUrl
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יוצר כתובת URL לשדרוג הארגון, כדי לשדרג קבוצת חשבונות קיימת של Google Play לארגונים לדומיין מנוהל ב-Google. פרטים נוספים זמינים במדריך.
בקשת HTTP
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
name |
string
חובה. השם של הארגון שיש לשדרג בטופס enterprises/{enterpriseId}.
|
גוף הבקשה
גוף הבקשה מכיל נתונים עם המבנה הבא:
| ייצוג ב-JSON |
{
"allowedDomains": [
string
],
"adminEmail": string
} |
| שדות |
allowedDomains[] |
string
אופציונלי. רשימת הדומיינים שמותרים לכתובת האימייל של האדמין. אדמין ה-IT לא יכול להזין כתובת אימייל עם שם דומיין שלא מופיע ברשימה הזו. אסור להשתמש בתת-דומיינים של דומיינים ברשימה הזו, אבל אפשר להשתמש בהם אם מוסיפים רשומה שנייה עם הקידומת *. לשם הדומיין (למשל *.example.com). אם השדה לא קיים או שהוא רשימה ריקה, האדמין יכול להשתמש בכל שם דומיין תקין. אסור להשתמש בדומיינים של כתובות אימייל אישיות.
|
adminEmail |
string
אופציונלי. כתובת האימייל שמשמשת למילוי מראש של שדה האדמין בטופס ההרשמה לחשבון בארגון, כחלק מתהליך השדרוג. הערך הזה הוא רק רמז והמשתמש יכול לשנות אותו. אסור להשתמש בכתובות אימייל אישיות. אם הערך של allowedDomainsallowedDomains
|
גוף התשובה
הודעת תגובה ליצירת כתובת URL לשדרוג של קבוצת חשבונות קיימת של Google Play לארגונים לדומיין מנוהל ב-Google.
הערה: התכונה הזו לא זמינה לכלל המשתמשים.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
{
"url": string
} |
| שדות |
url |
string
כתובת URL שאדמין בארגון יכול להשתמש בה כדי לשדרג את הארגון. אי אפשר לעבד את הדף ב-iframe.
|
היקפי הרשאה
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/androidmanagement
מידע נוסף זמין במאמר בנושא OAuth 2.0 Overview.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[],[],null,["# Method: enterprises.generateEnterpriseUpgradeUrl\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.GenerateEnterpriseUpgradeUrlResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGenerates an enterprise upgrade URL to upgrade an existing managed Google Play Accounts enterprise to a managed Google domain. See [the guide](https://developers.google.com/android/management/upgrade-an-enterprise) for more details.\n\n### HTTP request\n\n`POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*}:generateEnterpriseUpgradeUrl`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the enterprise to be upgraded in the form `enterprises/{enterpriseId}`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------|\n| ``` { \"allowedDomains\": [ string ], \"adminEmail\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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 not allowed. |\n| `adminEmail` | `string` Optional. Email address used to prefill the admin field of the enterprise signup form as part of the upgrade process. This value is a hint only and can be altered by the user. Personal email addresses are not allowed. If [`allowedDomains`](/android/management/reference/rest/v1/enterprises/generateEnterpriseUpgradeUrl#body.request_body.FIELDS.allowed_domains) is non-empty then this must belong to one of the [`allowedDomains`](/android/management/reference/rest/v1/enterprises/generateEnterpriseUpgradeUrl#body.request_body.FIELDS.allowed_domains). |\n\n### Response body\n\nResponse message for generating a URL to upgrade an existing managed Google Play Accounts enterprise to a managed Google domain.\n\n**Note:** This feature is not generally available.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------|\n| ``` { \"url\": string } ``` |\n\n| Fields ||\n|-------|--------------------------------------------------------------------------------------------------------------|\n| `url` | `string` A URL for an enterprise admin to upgrade their enterprise. The page can't be rendered in an iframe. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
