ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM).
مزيد من المعلومات
Enterprises: createWebToken
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض رمزًا مميزًا فريدًا للوصول إلى واجهة مستخدم قابلة للتضمين. لإنشاء
واجهة مستخدم الويب، مرِّر الرمز المميّز الذي تم إنشاؤه إلى JavaScript على "Google Play للأعمال".
واجهة برمجة التطبيقات. يمكن استخدام كل رمز مميّز لبدء جلسة واحدة فقط في واجهة المستخدم. يمكنك الاطّلاع على
مستندات JavaScript API لمزيد من المعلومات
الطلب
طلب HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/createWebToken
المعلمات
اسم المعلَمة |
القيمة |
الوصف |
مَعلمات المسار |
enterpriseId |
string |
رقم تعريف المؤسسة.
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
النطاق |
https://www.googleapis.com/auth/androidenterprise |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، قدِّم البيانات بالبنية التالية:
{
"kind": "androidenterprise#administratorWebTokenSpec",
"permission": [
string
],
"parent": string,
"playSearch": {
"enabled": boolean,
"approveApps": boolean
},
"privateApps": {
"enabled": boolean
},
"webApps": {
"enabled": boolean
},
"storeBuilder": {
"enabled": boolean
},
"managedConfigurations": {
"enabled": boolean
},
"zeroTouch": {
"enabled": boolean
}
}
اسم الموقع |
القيمة |
الوصف |
ملاحظات |
permission[] |
list |
تمّ الإيقاف. استخدام حساب "PlaySearch.approveApps ". |
|
parent |
string |
معرّف الموارد المنتظم (URI) للإطار الرئيسي الذي يستضيف إطار iframe. ولمنع استخدام بروتوكول XSS، قد لا تتم استضافة إطار iframe في معرّفات موارد منتظمة (URI) أخرى. يجب أن يكون معرّف الموارد المنتظم (URI) هذا https. استخدم المسافات البيضاء للفصل بين معرفات الموارد المنتظمة (URI) الرئيسية المتعددة. |
|
playSearch |
nested object |
خيارات عرض صفحة تطبيقات "بحث Play للأعمال" |
|
playSearch.enabled |
boolean |
ما إذا كان سيتم عرض صفحة تطبيقات "بحث Play للأعمال" أم لا. الإعداد التلقائي صحيح. |
|
playSearch.approveApps |
boolean |
السماح بالوصول إلى إطار iframe في وضع الموافقة القيمة التلقائية هي "خطأ". |
|
privateApps |
nested object |
خيارات عرض صفحة "التطبيقات الخاصة" |
|
privateApps.enabled |
boolean |
ما إذا كان سيتم عرض صفحة التطبيقات الخاصة أم لا. الإعداد التلقائي صحيح. |
|
webApps |
nested object |
خيارات عرض صفحة تطبيقات الويب |
|
webApps.enabled |
boolean |
ما إذا كان سيتم عرض صفحة تطبيقات الويب أم لا. الإعداد التلقائي صحيح. |
|
storeBuilder |
nested object |
خيارات عرض صفحة "تنظيم التطبيقات" |
|
storeBuilder.enabled |
boolean |
ما إذا كان سيتم عرض صفحة تنظيم التطبيقات أم لا. الإعداد التلقائي صحيح. |
|
managedConfigurations |
nested object |
خيارات عرض صفحة "الإعدادات المُدارة" |
|
managedConfigurations.enabled |
boolean |
ما إذا كان سيتم عرض صفحة الإعدادات المُدارة أم لا. الإعداد التلقائي صحيح. |
|
kind |
string |
|
|
zeroTouch |
nested object |
خيارات عرض صفحة "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" |
|
zeroTouch.enabled |
boolean |
تحدِّد هذه السياسة ما إذا كانت واجهة المستخدم المضمّنة في برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" قابلة للاستخدام باستخدام هذا الرمز المميّز. في حال تفعيل هذا الإعداد، يمكن للمشرف ربط حسابات عملاء برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" بهذه المؤسسة. |
|
الرد
في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:
{
"kind": "androidenterprise#administratorWebToken",
"token": string
}
اسم الموقع |
القيمة |
الوصف |
ملاحظات |
token |
string |
هو رمز مميّز مبهم يجب تمريره إلى واجهة Play الأمامية لإنشاء إطار iframe. |
|
kind |
string |
|
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-10 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-10 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGenerates a unique token for accessing an embeddable UI for managing Google Play apps in an enterprise.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body allows customization of which pages are displayed in the UI, such as Play Search, Private Apps, and Web Apps.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an opaque token to be used with the managed Google Play javascript API to generate the UI iframe.\u003c/p\u003e\n"],["\u003cp\u003eThe token is single-use and intended for one UI session only.\u003c/p\u003e\n"]]],[],null,["# Enterprises: createWebToken\n\n| **Note:** Requires [authorization](#auth).\n\nReturns a unique token to access an embeddable UI. To generate a\nweb UI, pass the generated token into the managed Google Play javascript\nAPI. Each token may only be used to start one UI session. See the\n[JavaScript API documentation](https://developers.google.com/api-client-library/javascript/apis/androidenterprise/v1) for further information.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/createWebToken\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\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\nIn the request body, supply data with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#administratorWebTokenSpec\",\n \"permission\": [\n string\n ],\n \"parent\": string,\n \"playSearch\": {\n \"enabled\": boolean,\n \"approveApps\": boolean\n },\n \"privateApps\": {\n \"enabled\": boolean\n },\n \"webApps\": {\n \"enabled\": boolean\n },\n \"storeBuilder\": {\n \"enabled\": boolean\n },\n \"managedConfigurations\": {\n \"enabled\": boolean\n },\n \"zeroTouch\": {\n \"enabled\": boolean\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `permission[]` | `list` | Deprecated. Use `PlaySearch.approveApps`. | |\n| `parent` | `string` | The URI of the parent frame hosting the iframe. To prevent XSS, the iframe may not be hosted at other URIs. This URI must be https. Use whitespaces to separate multiple parent URIs. | |\n| `playSearch` | `nested object` | Options for displaying the managed Play Search apps page. | |\n| playSearch.`enabled` | `boolean` | Whether the managed Play Search apps page is displayed. Default is true. | |\n| playSearch.`approveApps` | `boolean` | Allow access to the iframe in [approve mode](https://developers.google.com/android/work/play/emm-api/managed-play-iframe#render). Default is false. | |\n| `privateApps` | `nested object` | Options for displaying the Private Apps page. | |\n| privateApps.`enabled` | `boolean` | Whether the Private Apps page is displayed. Default is true. | |\n| `webApps` | `nested object` | Options for displaying the Web Apps page. | |\n| webApps.`enabled` | `boolean` | Whether the Web Apps page is displayed. Default is true. | |\n| `storeBuilder` | `nested object` | Options for displaying the Organize apps page. | |\n| storeBuilder.`enabled` | `boolean` | Whether the Organize apps page is displayed. Default is true. | |\n| `managedConfigurations` | `nested object` | Options for displaying the Managed Configuration page. | |\n| managedConfigurations.`enabled` | `boolean` | Whether the Managed Configuration page is displayed. Default is true. | |\n| `kind` | `string` | | |\n| `zeroTouch` | `nested object` | Options for displaying the Zero Touch page. | |\n| zeroTouch.`enabled` | `boolean` | Whether zero-touch embedded UI is usable with this token. If enabled, the admin can link zero-touch customers to this enterprise. | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#administratorWebToken\",\n \"token\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|---------------------------------------------------------------------------|-------|\n| `token` | `string` | An opaque token to be passed to the Play front-end to generate an iframe. | |\n| `kind` | `string` | | |"]]