إطار iframe في "Google Play للأعمال"

باستخدام إطار iframe في "Google Play للأعمال"، يمكنك تضمين "Google Play للأعمال" مباشرةً في وحدة تحكّم "إدارة الخدمات الجوّالة للمؤسسات" لتزويد العملاء بتجربة موحّدة لإدارة الخدمات الجوّالة.

إطار iframe في Google Play للأعمال
الشكل 1. إطار iframe في "Google Play للأعمال" الذي يعرض صفحة تطبيقات البحث.

يحتوي إطار iframe على شريط عناوين وقائمة جانبية قابلة للتوسيع. من القائمة، يمكن للمستخدمين الانتقال إلى صفحات مختلفة:

  • البحث في التطبيقات: تتيح لمشرفي تكنولوجيا المعلومات البحث عن تطبيقات Google Play وتصفّحها وعرض تفاصيل التطبيقات واختيار التطبيقات.
  • التطبيقات الخاصة: تتيح لمشرفي تكنولوجيا المعلومات نشر التطبيقات الخاصة وإدارتها لمؤسساتهم.
  • تطبيقات الويب: تسمح لمشرفي تكنولوجيا المعلومات بنشر اختصارات المواقع الإلكترونية وتوزيعها كتطبيقات.
  • تنظيم التطبيقات: يسمح لمشرفي تكنولوجيا المعلومات بضبط كيفية تنظيم التطبيقات في تطبيق "متجر Play" على أجهزة المستخدمين.

ويتم تفعيل جميع الصفحات في إطار iframe بشكلٍ تلقائي، ولكن يمكن إيقافها بشكلٍ فردي (راجع إضافة إطار iframe إلى وحدة التحكّم).

الميزات

يوضِّح هذا القسم الميزات المتاحة في إطار iframe في "Google Play للأعمال". للحصول على معلومات حول كيفية تضمين إطار iframe وتنفيذ هذه الميزات، يمكنك الاطّلاع على إضافة إطار iframe إلى وحدة التحكم الخاصة بك.

إضافة إطار iframe إلى وحدة التحكم

الخطوة 1. إنشاء رمز مميّز للويب

لإنشاء رمز ويب مميَّز يحدد هوية المؤسسة، يمكنك الاتصال بالرقم Enterprises.createWebToken. يوضِّح المثال التالي كيفية استرداد الرمز المميّز باستخدام مكتبة برامج واجهة برمجة التطبيقات لإدارة الخدمات الجوّالة للمؤسسات (EMM) في Google Play للغة Java.

ويتم تفعيل جميع الصفحات في إطار iframe تلقائيًا. عند إنشاء رمز ويب مميز، يمكنك تحديد الصفحة(الصفحات) التي يجب إيقافها. يعمل المثال أدناه على تعطيل التطبيقات الخاصة وتطبيقات الويب وتنظيم التطبيقات.

public AdministratorWebToken getAdministratorWebToken(
        String enterpriseId) throws IOException {
    AdministratorWebTokenSpec tokenSpec = new AdministratorWebTokenSpec();
    tokenSpec.setParent("https://my-emm-console.com");
    tokenSpec.setPlaySearch(new AdministratorWebTokenSpecPlaySearch());
    tokenSpec.setPrivateApps(new AdministratorWebTokenSpecPrivateApps().setEnabled(false));
    tokenSpec.setWebApps(new AdministratorWebTokenSpecWebApps().setEnabled(false));
    tokenSpec.setStoreBuilder(new AdministratorWebTokenSpecStoreBuilder().setEnabled(false));
    return androidEnterprise
        .enterprise()
        .createWebToken(enterpriseId, tokenSpec)
        .execute();
}

تحتاج إلى تضمين الرمز المميز المعروض، مع المعلمات الأخرى، عند عرض iframe في وحدة التحكم الخاصة بك.

الخطوة 2. عرض إطار iframe

في ما يلي مثال على كيفية عرض إطار iframe في "Google Play للأعمال":

<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT',
      'where': document.getElementById('container'),
      'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

يُنشئ هذا الرمز إطار iframe داخل الحاوية div. يمكن تعيين السمات التي سيتم تطبيقها على علامة iframe باستخدام خيار "السمات"، كما أعلاه.

معلمات عنوان URL

يسرد الجدول أدناه جميع المَعلمات المتاحة لإطار iframe والتي يمكن إضافتها إلى عنوان URL كمَعلمات لعناوين URL، مثل:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
المَعلمة الصفحة مطلوبة الوصف
token لا ينطبق نعم الرمز المميّز الذي تم عرضه من الخطوة 1
iframehomepage لا ينطبق لا يتم عرض الصفحة الأولية عند عرض إطار iframe. والقيم المحتملة هي PLAY_SEARCH وWEB_APPS وPRIVATE_APPS وSTORE_BUILDER (تنظيم التطبيقات). في حال عدم تحديد ذلك، سيحدّد ترتيب الأولوية التالي الصفحة التي سيتم عرضها: 1. PLAY_SEARCH، 2. PRIVATE_APPS، 3. WEB_APPS، 4. STORE_BUILDER.
locale لا ينطبق لا هي علامة لغة BCP 47 بتنسيق جيّد تُستخدَم لترجمة المحتوى في إطار iframe. إذا لم يتم تحديد القيمة، ستكون القيمة التلقائية هي en_US.
mode البحث في التطبيقات لا SELECT: تسمح لمشرفي تكنولوجيا المعلومات باختيار التطبيقات.
APPROVE (تلقائي): تسمح لمشرفي تكنولوجيا المعلومات باختيار التطبيقات والموافقة عليها وإلغاء الموافقة عليها. تم إيقاف هذا الوضع، ويمكنك استخدام SELECT بدلاً منه. لا يعمل وضع "الموافقة" إلا في حال ضبط PlaySearch.ApproveApps على true في الرمز المميّز للويب.
showsearchbox البحث في التطبيقات لا TRUE (تلقائي): لعرض مربّع البحث وبدء طلب البحث من داخل iframe.
FALSE: عدم عرض مربّع البحث
search البحث في التطبيقات لا سلسلة البحث. وإذا تم تحديد إطار iframe، سيوجِّه مشرف تكنولوجيا المعلومات إلى نتائج البحث باستخدام السلسلة المحدّدة.

الخطوة 3. التعامل مع أحداث iframe

يجب أيضًا معالجة الأحداث التالية كجزء من عملية الدمج.

حدثالوصف
onproductselect يختار المستخدم تطبيقًا أو يوافق عليه. ويؤدي ذلك إلى عرض عنصر يحتوي على:
{
    "packageName": The package name of the app, e.g. "com.google.android.gm",
    "productId": The product ID of the app, e.g. "app:com.google.android.gm",
    "action": The type of action performed on the document. Possible values are:
    "approved", "unapproved" or "selected." If you implement the iframe in SELECT
    mode, the only possible value is "selected".
}
يوضّح النموذج أدناه كيفية الاستماع إلى محتوى onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);