Важно! Мы больше не принимаем новых регистраций для Play EMM 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 на консоль .

Добавьте 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);