ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM). مزيد من المعلومات

إطار 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. يوضِّح المثال التالي كيفية استرداد الرمز المميّز باستخدام مكتبة برامج واجهة برمجة التطبيقات لإدارة الخدمات الجوّالة للمؤسسات في 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);