Google Play 管理版 iframe

您可以使用 Google Play 管理版 iframe 嵌入 Google Play 管理版。 直接在 EMM 控制台中，為客戶提供整合式行動管理服務 無須專人管理

Google Play 管理版 iframe
圖 1.Google Play 管理版 iframe 則顯示「搜尋應用程式」頁面。

iframe 包含標題列和可展開的側邊選單。在選單中 使用者可前往不同的頁面：

  • 搜尋應用程式：讓 IT 管理員搜尋及瀏覽 Google 例如瀏覽應用程式、查看應用程式詳細資料，然後選取應用程式。
  • 私人應用程式：讓 IT 管理員發布及管理私人應用程式 打造適合自家企業的應用程式
  • 網頁應用程式：允許 IT 管理員發布及發布網站 即可將捷徑視為應用程式
  • 整理應用程式：允許 IT 管理員設定應用程式的 是在使用者裝置的 Play 商店應用程式中設定的分類。

根據預設，iframe 中的所有網頁都會啟用，但你可以個別停用 iframe (請參閱將 iframe 新增至控制台)。

功能

本節說明 Google Play 管理版 iframe 提供的功能。 如要瞭解如何嵌入 iframe 並實作這些功能，請參閱 將 iframe 加到控制台。

將 iframe 新增至控制台

步驟 1：產生網路權杖

如要產生可識別企業的網路權杖，請呼叫 Enterprises.createWebToken。 以下範例說明如何使用 Google Play EMM 擷取符記 Java 適用的 API 用戶端程式庫。

在預設情況下，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

以下範例說明如何轉譯 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。屬性 可以使用「attributes」設定選項， 。

網址參數

下表列出可加到網址的 iframe 可用參數 做為網址參數，例如：

'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：讓 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);