Google Play 管理版 iframe

提示：如要查看 iframe 的實際運作範例，請試用 Android Management Experience。

您可以使用 Google Play 管理版 iframe，直接在 EMM 控制台中嵌入 Google Play 管理版，為客戶提供統一的行動管理服務體驗。

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

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

• 搜尋應用程式：IT 管理員可搜尋及瀏覽 Google Play 應用程式、查看應用程式詳細資料，以及選取應用程式。
• 私人應用程式：讓 IT 管理員發布及管理企業專用的私人應用程式。
• 網頁應用程式：IT 管理員可將網站捷徑發布及發送為應用程式。
• 整理應用程式：IT 管理員可設定使用者裝置上的 Play 商店應用程式分類方式。

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

---

功能

本節說明 Google Play 管理版 iframe 提供的功能。如要瞭解如何嵌入 iframe 並導入這些功能，請參閱「將 iframe 新增至控制台」。

搜尋應用程式

「搜尋應用程式」頁面 (如圖 1. 所示) 可讓 IT 管理員搜尋、瀏覽及選取 Google Play 應用程式。

搜尋框

根據預設，頁面上會啟用標題列中的搜尋框。搜尋框支援自動建議等功能，並會從 Google Play 公開列出的應用程式中傳回結果。搜尋結果會顯示在 iframe 中。

注意：如果控制台已內建搜尋功能，您可以停用搜尋框，並改為在 iframe 的網址中傳遞搜尋查詢。如需詳細資訊，請參閱「步驟 2：轉譯 iframe」中的「網址參數」。

注意：如果您要搜尋私人或網頁應用程式，請使用企業 ID 來更輕鬆地找到這些應用程式。如要查看企業 ID，請按一下 iFrame 右上角的人形齒輪圖示，然後複製 ID 欄位中的文字。

私人應用程式

圖 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 管理中心，並執行下列操作：

• 新增及管理管理員帳戶。
• 新增進階應用程式詳細資料，包括說明、螢幕截圖等。
• 取消發布應用程式。

如要瞭解 IT 管理員如何使用「私人應用程式」頁面，請前往 Google Play 管理版說明中心。

選取按鈕

應用程式發布後，IT 管理員可以在應用程式詳細資料頁面中編輯標題和 APK。應用程式詳細資料頁面也會顯示「SELECT」按鈕 (請參閱圖 2)。您需要指定 IT 管理員按下這個按鈕時要執行的動作 (請參閱步驟 3 中的 onproductselect)。處理 iframe 事件)。

網頁應用程式

圖 3. 網頁應用程式建立表單。

網頁應用程式頁面可讓 IT 管理員將網站捷徑以私人應用程式的形式發布至 Google Play 管理版。網頁應用程式可透過套件名稱 (productId) 識別，通常需要 10 分鐘才能發布。發布後，系統會自動為企業核准，並可像其他核准的應用程式一樣，分發給使用者。網頁應用程式與其他 Google Play 管理版 iframe 功能相容：可在 Play 搜尋頁面中搜尋，並加入至集合中。

警告：網頁應用程式的標題和圖示必須符合《Google Play 開發人員計畫政策》。不符合規定的應用程式不會發布，且會持續列為「尚未發布」。

網頁應用程式建立表單需要標題、HTTPS 或 HTTP 網址，以及圖示圖片 (512 x 512 JPG 或 32 位元 PNG)。此外，IT 管理員可以選擇下列三種顯示選項：

• 全螢幕：應用程式會以全螢幕模式開啟，並隱藏裝置的狀態列和導覽列。
• 一般版 UI (預設)：應用程式會顯示裝置的狀態列和導覽列。
• 極簡版 UI：應用程式會顯示裝置的狀態列和導覽列、應用程式網址和重新整理選項。如果是 HTTP 網址，則只能選用這個選項。

重要事項：網頁應用程式會在使用者選取的預設瀏覽器中開啟 (「設定」>「應用程式」>「預設應用程式」>「瀏覽器應用程式」)。功能 (例如全螢幕、獨立模式、簡易 UI) 取決於使用者選取的預設瀏覽器相容性。請注意，部分瀏覽器可能不支援所有這些功能。IT 管理員應在部署前確認瀏覽器相容性。

IT 管理員也可以在「網頁應用程式」頁面中編輯及刪除網頁應用程式。刪除網頁應用程式時會將其從使用者的 Google Play 管理版商店中移除，但如果應用程式已安裝在裝置上，使用者仍可存取該應用程式。如要從使用者的裝置上刪除網頁應用程式，請參閱刪除應用程式。如要瞭解使用者如何建立及編輯網頁應用程式，請參閱 Google Play 管理版說明中心。

選取按鈕

發布網頁應用程式後，其詳細資料頁面會包含「SELECT」按鈕。您需要指定 IT 管理員按下這個按鈕時要執行的動作 (例如發布應用程式)，請參閱步驟 3 中的 onproductselect。處理 iframe 事件)。

整理應用程式

圖 4. Google Play 管理版 iframe，顯示「整理應用程式」頁面。

在「整理應用程式」頁面中，IT 管理員可以將應用程式分類為集合 (又稱為「叢集」)。舉例來說，IT 管理員可以為常用的應用程式建立「Essentials」集合，或是為追蹤費用、記錄旅遊等相關應用程式建立「支出」集合。集合會顯示在使用者裝置的 Play 商店首頁。

EMM 必須使用 iframe 網址參數中的 SELECT mode，才能搜尋應用程式並將應用程式加入集合。

在使用者的裝置上，Play 商店應用程式只會顯示使用者 (或裝置) 可用的收藏應用程式。如果集合中沒有任何可供使用者 (或裝置) 使用的應用程式，集合就不會顯示在 Play 商店中。

圖 5. 裝置上的應用程式組合 (叢集)
。

IT 管理員也可以在「整理應用程式」頁面中編輯、刪除及複製現有的收藏。如需操作說明，請參閱 Google Play 管理版說明中心。

---

將 iframe 新增至控制台

步驟 1：產生網頁權杖

如要產生可識別企業的網頁權杖，請呼叫 Enterprises.createWebToken。以下範例說明如何使用 適用於 Java 的 Google Play EMM 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

以下是如何算繪受管理的 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 代碼的屬性。

網址參數

下表列出 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 管理員選取、核准及取消核准應用程式。 已淘汰： 這個模式已淘汰，請改用 SELECT。 2025 年 9 月 30 日後，任何人都無法再使用這個方法。 APPROVE 模式只有在網頁權杖中的 PlaySearch.ApproveApps 設為 true 時才有效。
showsearchbox	搜尋應用程式	否	TRUE (預設)：顯示搜尋框，並在 iframe 中啟動搜尋查詢。 FALSE：系統不會顯示搜尋框。
search	搜尋應用程式	否	搜尋字串。如果指定了這個參數，iframe 會將 IT 管理員導向使用指定字串的搜尋結果。 注意： 只有在搜尋方塊位於 iframe (showsearchbox = FALSE) 外部時，才納入這個參數。

步驟 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);