Управляемый 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 в консоль .

Поиск приложений

Страница «Поиск приложений» (показана на рис. 1. ) позволяет ИТ-администраторам искать, просматривать и выбирать приложения Google Play.

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

Частные приложения

частные приложения
Рисунок 2. Экран сведений о частном приложении

Страница «Частные приложения» позволяет ИТ-администраторам публиковать частные приложения и управлять ими непосредственно из консоли EMM. Чтобы упростить публикацию частных приложений для ИТ-администраторов, на странице:

  • Автоматически создает учетную запись Play Console от имени предприятия и предоставляет ИТ-администраторам доступ администратора.
  • Отменяется регистрационный сбор Play Console в размере 25 долларов США, который ранее требовался для публикации приложений.
  • Требуется только APK и название приложения.
  • Публикует приложения всего за 10 минут (по сравнению с 2 часами в Play Console).
    Примечание. Приложения, опубликованные на странице «Частные приложения», никогда не могут быть опубликованы.

Когда ИТ-администратор впервые публикует приложение в iframe, iframe автоматически создает учетную запись Play Console от имени предприятия. Если они вносят расширенные изменения , им будет предложено войти в систему с использованием учетной записи Google — это может быть любая учетная запись Google (например, Gmail, Cloud Identity). Этот аккаунт Google добавляется в качестве администратора корпоративной учетной записи Play Console. После этого ИТ-администратор может использовать свою учетную запись Google для прямого входа в консоль Play, где он может:

Инструкции для ИТ-администраторов по использованию страницы частных приложений доступны в управляемом Справочном центре Google Play.

Кнопка выбора

После публикации приложения ИТ-администратор может изменить его название и APK на странице сведений о приложении. На странице сведений о приложении также отображается кнопка ВЫБРАТЬ (см. рис. 2 ). Вам необходимо указать действие, которое произойдет, когда ИТ-администратор нажмет эту кнопку (см. onproductselect в шаге 3. Обработка событий iframe ).

Веб-приложения

веб-приложения
Рисунок 3. Форма создания веб-приложения.

Страница веб-приложений позволяет ИТ-администраторам публиковать ярлыки веб-сайтов как частные приложения в управляемом Google Play. Веб-приложения идентифицируются по имени пакета ( productId ), и их публикация обычно занимает 10 минут. После публикации они автоматически утверждаются для своего предприятия и могут распространяться среди пользователей, как и любое другое одобренное приложение. Веб-приложения совместимы с другими управляемыми функциями Play iframe: их можно искать на странице поиска Play, и их можно добавлять в коллекции.

Для формы создания веб-приложения требуется заголовок, URL-адрес HTTPS или HTTP и изображение значка (512 x 512 JPG или 32-битный PNG). Кроме того, ИТ-администраторы могут выбирать один из трех вариантов отображения:

  • Полноэкранный режим: приложение открывается в полноэкранном режиме, скрывая строку состояния и панель навигации устройства.
  • Автономный (по умолчанию): приложение отображает строку состояния и панель навигации устройства.
  • Минимальный пользовательский интерфейс: приложение отображает строку состояния и панель навигации устройства, URL-адрес приложения и возможность обновления. Для URL-адресов HTTP это единственный доступный вариант.

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

Кнопка выбора

После публикации веб-приложения на его странице сведений появляется кнопка ВЫБРАТЬ. Вам необходимо указать действие (например, распространение приложения), которое происходит, когда ИТ-администратор нажимает на эту кнопку (см. onproductselect в Шаге 3. Обработка событий iframe ).

Упорядочение приложений

организовывать приложения
Рис. 4. Управляемый iframe Google Play со страницей «Упорядочить приложения».

Страница «Упорядочить приложения» позволяет ИТ-администраторам организовывать приложения в коллекции (также называемые кластерами ). Например, ИТ-администратор может создать коллекцию Essentials для часто используемых приложений или коллекцию «Расходы» для приложений, связанных с отслеживанием расходов, регистрацией поездок и т. д. Коллекции отображаются на домашней странице Play Store на устройствах пользователя.

EMM должны использовать SELECT mode в параметрах URL-адреса iframe, чтобы разрешить поиск и добавление приложений в коллекции.

На устройствах пользователя приложение Play Store отображает только приложения из коллекции, доступные пользователю (или устройству). Если в коллекции нет приложений, доступных пользователю (или устройству), она не появится в Play Store.

управляемый Google Play iframe
Рисунок 5. Коллекции приложений ( кластеры )
на устройстве.

ИТ-администраторы также могут редактировать, удалять и копировать существующие коллекции на странице организации приложений. Инструкции для пользователя по выполнению этих задач доступны в Справочном центре управляемого Google Play .


Добавьте 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 (по умолчанию): позволяет ИТ-администраторам выбирать, утверждать и отменять утверждение приложений.
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);