مدیریت Google Play iframe

با iframe مدیریت شده Google Play ، می‌توانید Google Play مدیریت شده را مستقیماً در کنسول EMM خود جاسازی کنید تا یک تجربه مدیریت حرکتی یکپارچه را به مشتریان ارائه دهید.

iframe Google Play مدیریت شده
شکل 1. iframe مدیریت شده Google Play که صفحه برنامه های جستجو را نشان می دهد.

iframe حاوی یک نوار عنوان و یک منوی جانبی قابل ارتقا است. از منو، کاربران می توانند به صفحات مختلف پیمایش کنند:

  • جستجوی برنامه‌ها : به مدیران فناوری اطلاعات اجازه می‌دهد برنامه‌های Google Play را جستجو و مرور کنند، جزئیات برنامه را مشاهده کنند و برنامه‌ها را انتخاب کنند.
  • برنامه‌های خصوصی : به مدیران فناوری اطلاعات اجازه می‌دهد برنامه‌های خصوصی را برای شرکت خود منتشر و مدیریت کنند.
  • برنامه های وب : به مدیران فناوری اطلاعات اجازه می دهد میانبرهای وب سایت را به عنوان برنامه منتشر و توزیع کنند.
  • سازمان‌دهی برنامه‌ها : به مدیران فناوری اطلاعات اجازه می‌دهد نحوه سازماندهی برنامه‌ها را در برنامه Play Store در دستگاه‌های کاربر خود پیکربندی کنند.

همه صفحات به طور پیش فرض در iframe فعال هستند، اما می توان آنها را به صورت جداگانه غیرفعال کرد (به افزودن iframe به کنسول خود مراجعه کنید).


امکانات

این بخش ویژگی های موجود در iframe مدیریت شده Google Play را شرح می دهد. برای اطلاعات در مورد نحوه جاسازی iframe و اجرای این ویژگی‌ها، به افزودن iframe به کنسول خود مراجعه کنید.


iframe را به کنسول خود اضافه کنید

مرحله 1. یک توکن وب ایجاد کنید

برای ایجاد یک نشانه وب که شرکت را شناسایی می کند، Enterprises.createWebToken فراخوانی کنید. مثال زیر نحوه بازیابی رمز را با استفاده از Google Play EMM API Client Library برای جاوا نشان می‌دهد.

همه صفحات در 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 مدیریت شده 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 N/A آره توکن از مرحله 1 برگشت.
iframehomepage N/A خیر صفحه اولیه که هنگام رندر شدن iframe نمایش داده می شود. مقادیر ممکن عبارتند از PLAY_SEARCH ، WEB_APPS ، PRIVATE_APPS ، و STORE_BUILDER (سازماندهی برنامه ها). اگر مشخص نشده باشد، ترتیب اولویت زیر تعیین می‌کند که کدام صفحه نمایش داده شود: 1. PLAY_SEARCH ، 2. PRIVATE_APPS ، 3. WEB_APPS ، 4. STORE_BUILDER .
locale N/A خیر یک برچسب زبان 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);