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

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

إطار 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 باستخدام السمة "attributes" (السمات) كخيار أعلاه.

معلمات عنوان 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 (تلقائي): يتيح لمشرفي تكنولوجيا المعلومات اختيار التطبيقات والموافقة عليها وإلغاء الموافقة عليها.
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);