Управляемый iframe Google Play

С помощью управляемого Google Play iframe вы можете встроить управляемый Google Play непосредственно в консоль EMM, чтобы предложить клиентам единый интерфейс управления мобильностью.

управляемый Google Play iframe
Рисунок 1. Управляемый iframe Google Play, показывающий страницу приложений поиска.

iframe содержит строку заголовка и расширяемое боковое меню. Из меню пользователи могут переходить на разные страницы:

  • Поиск приложений : позволяет ИТ-администраторам искать и просматривать приложения Google Play, просматривать сведения о приложениях и выбирать приложения.
  • Частные приложения : позволяет ИТ-администраторам публиковать частные приложения для своего предприятия и управлять ими.
  • Веб-приложения : позволяет ИТ-администраторам публиковать и распространять ярлыки веб-сайтов в виде приложений.
  • Упорядочивать приложения : позволяет ИТ-администраторам настраивать порядок организации приложений в приложении Play Store на устройствах своих пользователей.

По умолчанию все страницы включены в iframe, но их можно отключить по отдельности (см. Добавление iframe в консоль ).


Функции

В этом разделе описаны функции, доступные в управляемом iframe Google Play. Информацию о том, как встроить iframe и реализовать эти функции, см. в разделе Добавление iframe в консоль .


Добавьте iframe в консоль

Шаг 1. Создайте веб-токен

Чтобы создать веб-токен, идентифицирующий предприятие, вызовите Enterprises.createWebToken . В следующем примере показано, как получить токен с помощью клиентской библиотеки Google Play EMM API для 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 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. Режим APPROVE работает только в том случае, если для параметра 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);