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

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إطار 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 إلى وحدة التحكّم.

البحث في التطبيقات

تتيح صفحة "البحث عن التطبيقات" (المعروضة في الشكل 1) لمشرفي تكنولوجيا المعلومات البحث عن تطبيقات Google Play وتصفّحها واختيارها.

يكون مربّع البحث في شريط العنوان مفعّلاً في الصفحة تلقائيًا. يتيح مربّع البحث ميزات، مثل ميزة "اقتراحات تلقائية"، ويعرض نتائج من التطبيقات المُدرَجة بشكل علني على Google Play. يتم عرض نتائج البحث داخل إطار iframe.

التطبيقات الخاصة

تسمح صفحة "التطبيقات الخاصة" لمشرفي تكنولوجيا المعلومات بنشر التطبيقات الخاصة وإدارتها مباشرةً من وحدة تحكّم "إدارة الخدمات الجوّالة للمؤسسات". لتبسيط عملية نشر التطبيقات الخاصة لمشرفي تكنولوجيا المعلومات، توفّر الصفحة ما يلي:

يتم إنشاء حساب Play Console بصمت نيابةً عن المؤسسة، ويتم منح إذن وصول المشرف إلى مشرفِي تكنولوجيا المعلومات.
إلغاء رسوم التسجيل في Play Console التي كانت تبلغ 25 دولارًا أمريكيًا (أو ما يعادلها بالعملة المحلية) والتي كانت مطلوبة سابقًا لنشر التطبيقات
يتطلب ملف APK للتطبيق وعنوانًا فقط.
نشر التطبيقات في غضون 10 دقائق كحدٍّ أقصى (مقارنةً بساعتَين في Play Console)
ملاحظة: لا يمكن مطلقًا نشر التطبيقات التي تم نشرها من صفحة "التطبيقات الخاصة" للجميع.

في المرة الأولى التي ينشر فيها مشرف تكنولوجيا المعلومات تطبيقًا في إطار iframe، ينشئ إطار iframe حسابًا على Play Console نيابةً عن المؤسسة بدون إشعار. إذا أجروا تعديلات متقدّمة، سيُطلب منهم تسجيل الدخول باستخدام حساب Google، ويمكن أن يكون أي حساب على Google (مثل Gmail أو Cloud Identity). تتم إضافة حساب Google هذا كمشرف لحساب المؤسسة على Play Console. بعد ذلك، يمكن لمشرف تكنولوجيا المعلومات استخدام حسابه على Google لتسجيل الدخول إلى Play Console مباشرةً، حيث يمكنه إجراء ما يلي:

إضافة حسابات المشرفين وإدارتها
أضِف تفاصيل التطبيق المتقدّمة، بما في ذلك الأوصاف ولقطات الشاشة وغير ذلك.
إلغاء نشر التطبيقات

تتوفّر تعليمات لمشرفي تكنولوجيا المعلومات حول كيفية استخدام صفحة "التطبيقات الخاصة" في مركز مساعدة "Google Play للأعمال".

زر الاختيار

بعد نشر تطبيق، يمكن لمشرف تكنولوجيا المعلومات تعديل عنوانه وملف APK الخاص به في صفحة تفاصيل التطبيق. تعرِض صفحة تفاصيل التطبيق أيضًا زر SELECT (راجِع الشكل 2). عليك تحديد الإجراء الذي يتم تنفيذه عندما ينقر مشرف تكنولوجيا المعلومات على هذا الزر (راجِع onproductselect في الخطوة 3. التعامل مع أحداث iframe).

تطبيقات الويب

تتيح صفحة "تطبيقات الويب" لمشرفي تكنولوجيا المعلومات نشر اختصارات المواقع الإلكترونية كتطبيقات خاصة على "Google Play للأعمال". يمكن التعرّف على تطبيقات الويب من خلال اسم الحزمة (productId)، وتستغرق عادةً عملية نشرها 10 دقائق. وبعد النشر، تتم الموافقة تلقائيًا على استخدامها في المؤسسة ويمكن توزيعها على المستخدمين تمامًا مثل أي تطبيق آخر تمت الموافقة عليه. وتتوافق تطبيقات الويب مع ميزات إطار iframe الأخرى في "Google Play للأعمال": يمكن البحث عنها في صفحة "بحث Play" ويمكن إضافتها إلى المجموعات.

يتطلب نموذج إنشاء تطبيق الويب عنوانًا وعنوان URL لبروتوكول HTTPS أو HTTP وصورة رمز (بتنسيق JPG بدقة 512 × 512 أو بتنسيق PNG بسعة 32 بت). بالإضافة إلى ذلك، يمكن لمشرفي تكنولوجيا المعلومات الاختيار من بين خيارات العرض الثلاثة التالية:

ملء الشاشة: يتم فتح التطبيق في وضع ملء الشاشة، ما يؤدي إلى إخفاء شريطَي التنقُّل وحالة الجهاز.
مستقل (تلقائي): يعرض التطبيق شريط حالة الجهاز وشريط التنقّل.
واجهة مستخدم مصغَّرة: يعرض التطبيق شريط حالة الجهاز وشريط التنقّل وعنوان URL للتطبيق وخيار التحديث. بالنسبة إلى عناوين URL التي تستخدم HTTP، هذا هو الخيار الوحيد المتاح.

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

زر الاختيار

بعد نشر تطبيق ويب، يتضمّن زر SELECT في صفحة التفاصيل الخاصة به. عليك تحديد الإجراء (مثل توزيع التطبيق) الذي يتم تنفيذه عندما ينقر مشرف تكنولوجيا المعلومات على هذا الزر (راجِع onproductselect في الخطوة 3). معالجة أحداث iframe).

تنظيم التطبيقات

تتيح صفحة "تنظيم التطبيقات" لمشرفي تكنولوجيا المعلومات تنظيم التطبيقات في مجموعات (يُطلق عليها أيضًا المجموعات). على سبيل المثال، يمكن لمشرف تكنولوجيا المعلومات إنشاء مجموعة التطبيقات الأساسية لجمع التطبيقات المستخدَمة بشكلٍ متكرّر أو مجموعة النفقات للتطبيقات ذات الصلة بتتبُّع النفقات وتسجيل الرحلات وما إلى ذلك. ويتم عرض المجموعات في الصفحة الرئيسية لمتجر Play على أجهزة المستخدمين.

يجب أن تستخدِم خدمات إدارة الخدمات الجوّالة للمؤسسات SELECT mode في مَعلمات عنوان URL لإطار iframe للسماح بالبحث عن التطبيقات وإضافتها إلى المجموعات.

على أجهزة المستخدم، لا يعرض تطبيق "متجر Play" سوى التطبيقات من مجموعة متوفّرة للمستخدم (أو الجهاز). إذا لم تتضمّن المجموعة أي تطبيقات متاحة للمستخدم (أو الجهاز)، لن تظهر المجموعة في "متجر Play".

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

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

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

لإنشاء رمز مميّز للويب يحدِّد المؤسسة، اتصل بـ Enterprises.createWebToken. يوضّح المثال التالي كيفية استرداد الرمز المميّز باستخدام مكتبة عميل واجهة برمجة التطبيقات Google Play EMM للغة 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` بدلاً منه. لن يعود بإمكان أي مستخدم الوصول إلى هذه الطريقة بعد 30 أيلول (سبتمبر) 2025. لا يعمل وضع `APPROVE` إلا إذا تم ضبط `PlaySearch.ApproveApps` على `true` في رمز الويب المميّز.
`showsearchbox`	البحث في التطبيقات	لا	‫`TRUE` (الإعداد التلقائي): يعرض مربّع البحث ويشغّل طلب البحث من داخل إطار iframe. `FALSE`: لا يتم عرض مربّع البحث.
`search`	البحث في التطبيقات	لا	سلسلة البحث إذا تم تحديده، يوجّه إطار iframe مشرف تكنولوجيا المعلومات إلى نتائج البحث باستخدام السلسلة المحدّدة. ملاحظة: لا تُدرِج هذه المَعلمة إلا عندما يكون مربع البحث خارج إطار iframe (`showsearchbox = FALSE`).

الخطوة 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

يختار المستخدم تطبيقًا أو يوافق عليه. يؤدي ذلك إلى عرض عنصر يحتوي على ما يلي:

{
    "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);