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

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

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

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