Google Play 企业版 iframe

借助 Google Play 企业版 iframe,您可以嵌入 Google Play 企业版 直接在 EMM 控制台中操作,以便为客户提供统一的移动管理 体验

<ph type="x-smartling-placeholder">
</ph> Google Play 企业版 iframe
图 1.Google Play 企业版 iframe “搜索应用”页面。

iframe 包含一个标题栏和一个可展开的侧边菜单。在菜单中 用户可以导航到不同的页面:

  • 搜索应用:允许 IT 管理员搜索和浏览 Google 播放应用、查看应用详情和选择应用。
  • 专用应用:让 IT 管理员能够发布和管理专用应用 应用。
  • Web 应用:IT 管理员用来发布和分发网站 快捷方式作为应用。
  • 整理应用:允许 IT 管理员配置应用的显示方式 在用户设备上的 Play 商店应用内整理得井井有条

默认情况下,所有网页在 iframe 中处于启用状态,但可以单独停用 (请参阅将 iframe 添加到控制台)。


功能

本部分介绍了 Google Play 企业版 iframe 提供的功能。 有关如何嵌入 iframe 并实现这些功能的信息,请参见 将 iframe 添加到控制台

搜索应用

IT 管理员可以使用“搜索应用”页面(如图 1 所示)搜索、浏览和 部分 Google Play 应用。

默认情况下,系统会在网页上启用标题栏中的搜索框。搜索框支持各种功能 例如自动建议功能,并返回 Google Play 上公开列出的应用的结果。搜索 结果会显示在 iframe 中。

专用应用

<ph type="x-smartling-placeholder">
</ph> 专用应用
图 2.专用应用详情屏幕

借助“专用应用”页面,IT 管理员可以直接通过您的 EMM 发布和管理专用应用 控制台。为了简化 IT 管理员专用应用的发布流程,此页面:

  • 代表企业创建 Play 管理中心账号,并向以下对象授予管理员访问权限:静默 IT 管理员。
  • 免除了之前发布应用所需的 25 美元的 Play 管理中心注册费。
  • 仅要求提供应用的 APK 和名称。
  • 短短 10 分钟即可发布应用(而在 Play 管理中心为 2 小时)。
    注意:通过“专用应用”页面发布的应用绝不能设为公开。

IT 管理员首次在 iframe 中发布应用时,iframe 会静默创建一个 Play 代表企业的控制台账号。如果他们进行高级修改,会收到提示 可以使用 Google 账号登录,可以是任意 Google 账号(如 Gmail、Cloud Identity)。 系统会将此 Google 账号添加为企业的 Play 管理中心账号的管理员。之后,系统会 IT 管理员可以使用 Google 账号直接登录 Play 管理中心, 可以:

  • 将和 管理账号
  • 添加高级应用详细信息,包括说明、屏幕截图等。
  • 取消发布应用。

有关如何使用“专用应用”页面的说明,请访问 Google Play 企业版帮助 中心

选择按钮

应用发布后,IT 管理员可以在应用详情页面中修改其标题和 APK。通过 应用详情页面还会显示选择按钮(参见图 2)。你需要指定 IT 管理员点击此按钮后会执行的操作(请参阅 onproductselect(在第 3 步:处理 iframe 事件)。

Web 应用

<ph type="x-smartling-placeholder">
</ph> Web 应用
图 3.Web 应用创建表单。

通过“网页应用”页面,IT 管理员可以将网站快捷方式作为专用应用发布到 Google Play 企业版。 Web 应用可通过其软件包名称 (productId) 标识,通常需要 10 个 分钟进行发布。应用发布后,系统会自动批准 分发给用户,就像其他任何已获批准的应用一样。Web 应用可与其他受管理的应用兼容 Play iframe 功能:用户可以在 Play 搜索页中搜索这些功能,还可以将其添加到 。

Web 应用创建表单需要标题、HTTPS 或 HTTP 网址以及图标图片(512 x 512 JPG 或 32 位 PNG)。此外,IT 管理员可以从以下三种显示选项中进行选择:

  • 全屏:应用会在全屏模式下打开,隐藏设备的状态栏和导航栏。
  • 独立(默认):应用会显示设备的状态栏和导航栏。
  • 极简界面:应用会显示设备的状态栏和导航栏、应用网址和刷新内容 选项。对于 HTTP 网址,这是唯一可用选项。

IT 管理员还可以通过“Web 应用”页面修改和删除 Web 应用。删除 Web 应用会将其移除 ,但如果应用 已安装在他们的设备上。如需从用户的设备中删除 Web 应用,请参阅 删除应用。面向用户的操作说明 可用于创建和修改 Google Play 企业版帮助 中心

选择按钮

Web 应用发布后,其详情页面会包含一个“选择”按钮。您需要指定 在 IT 管理员点击此按钮后执行的操作(例如,分发应用) (参见 onproductselect第 3 步:标识名 iframe 事件)。

整理应用

<ph type="x-smartling-placeholder">
</ph> 整理应用
图 4.Google Play 企业版 iframe “整理应用”页面。

“整理应用”页面可让 IT 管理员将应用整理为集合(也称为 clusters)。例如,IT 管理员可以创建一个“基本功能版”集合,以便 常用应用或支出集合(针对与支出跟踪相关的应用); 记录旅行等。合集会显示在用户设备上的 Play 商店首页中。

EMM 必须使用 SELECT mode,以允许搜索和添加应用 添加到集合中。

在用户的设备上,Play 商店应用仅会显示应用集合中可供 用户(或设备)。如果集合不包含任何可供用户使用的应用(或者 因此该集合不会显示在 Play 商店中。

<ph type="x-smartling-placeholder">
</ph> Google Play 企业版 iframe
图 5.设备上的应用集合(集群

IT 管理员还可以在“整理应用”页面中修改、删除和复制现有集合。用户 有关如何执行这些任务的说明,请参见 Google Play 企业版帮助 中心


将 iframe 添加到您的控制台

第 1 步:生成网络令牌

要生成用于标识企业的网络令牌,请调用 Enterprises.createWebToken。 以下示例展示了如何使用 Google Play EMM 检索令牌 适用于 Java 的 API 客户端库

iframe 中的所有网页在默认情况下均处于启用状态。生成网络令牌时,您需要 可指定要停用的网页。以下示例会停用专用应用 Web 应用,以及整理应用。

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

以下示例展示了如何呈现 Google Play 企业版 iframe:

<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>

此代码会在容器 div 内生成一个 iframe。属性 可以通过“属性”设置选项,如 。

网址参数

下表列出了可添加到网址的 iframe 的所有可用参数 作为网址参数,例如:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
参数 网页 必填 说明
token 不适用 第 1 步返回的令牌。
iframehomepage 不适用 呈现 iframe 时显示的初始页面。可能的值包括 PLAY_SEARCHWEB_APPSPRIVATE_APPSSTORE_BUILDER(整理应用)。如果未指定,则以下顺序 优先级决定显示哪个页面:1.PLAY_SEARCH、2.PRIVATE_APPS、3. WEB_APPS、4.STORE_BUILDER
locale 不适用 格式正确的 BCP 47 语言标记 ,用于在 iframe 中本地化内容。如果未指定,则 默认值为 en_US
mode 搜索应用 SELECT:允许 IT 管理员选择应用。
APPROVE(默认):允许 IT 管理员选择、批准和取消批准应用。
showsearchbox 搜索应用 TRUE(默认):显示搜索框和 在 iframe 内发起搜索查询。
FALSE: 则不会出现搜索框。
search 搜索应用 搜索字符串。如果已指定,该 iframe 会将 IT 管理员定向到 指定的字符串。

第 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);