重要資訊：我們目前不接受新的 Play EMM API 註冊。瞭解詳情。

本頁面由 Cloud Translation API 翻譯而成。

Google Play 管理版 iframe

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

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

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

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

功能

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

搜尋應用程式

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

根據預設，網頁會啟用標題列中的搜尋框。搜尋框支援多種功能，例如自動建議及傳回 Google Play 公開應用程式的結果。搜尋結果會在 iframe 內顯示。

私人應用程式

「私人應用程式」頁面可讓 IT 管理員直接透過 EMM 發布及管理私人應用程式控制台。如要簡化 IT 管理員的私人應用程式發布流程，請參閱頁面：

自動代表企業建立 Play 管理中心帳戶，並授予以下存取權的管理員存取權： IT 管理員。
減免先前發布應用程式時須支付的 $25 美元 Play 管理中心註冊費。
只需要應用程式的 APK 和名稱。
應用程式的發布作業最短只需 10 分鐘 (Play 管理中心是 2 小時的發布時間)。
注意：從「私人應用程式」頁面發布的應用程式一律無法設為公開。

IT 管理員首次在 iframe 中發布應用程式時，iFrame 會建立 Google Play，且不會顯示通知。。如果使用者使用進階編輯功能，系統會提示使用者使用 Google 帳戶登入；這個帳戶可以是任何 Google 帳戶，例如 Gmail、Cloud Identity。這個 Google 帳戶已新增為企業 Play 管理中心帳戶的管理員。之後 IT 管理員可以使用 Google 帳戶直接登入 Play 管理中心。可以：

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

如需 IT 管理員使用「私人應用程式」頁面的操作說明，請前往 Google Play 管理版說明。

選取按鈕

應用程式發布後，IT 管理員可以在應用程式詳細資料頁面中編輯名稱和 APK。應用程式詳細資料頁面也會顯示「SELECT」按鈕 (請見圖 2)。您必須指定 IT 管理員點選這個按鈕後採取的動作 (請參閱 onproductselect (步驟 3：處理 iframe 事件)。

網頁應用程式

透過「網頁應用程式」頁面，IT 管理員可將網站捷徑以私人應用程式的形式發布至 Google Play 管理版。網頁應用程式可依套件名稱 (productId) 識別，通常為 10 個發布影片發布後，系統會自動核准向使用者發布的內容，與其他經核准的應用程式相同。網頁應用程式與其他受管理的應用程式相容 Play iframe 功能：支援在 Play 搜尋頁面搜尋，也可以新增到集合。

網頁應用程式建立表單必須包含標題、HTTPS 或 HTTP 網址和圖示圖片 (512 x 512 JPG 或 32 位元 PNG)。此外，IT 管理員有以下三種顯示選項：

全螢幕：應用程式會以全螢幕模式開啟，並隱藏裝置的狀態列和導覽列。
獨立式 (預設)：應用程式會顯示裝置的狀態列和導覽列。
極簡風 UI：應用程式會顯示裝置的狀態列和導覽列、應用程式網址，以及重新整理畫面如果有需要 SQL 指令的分析工作負載則 BigQuery 可能是最佳選擇如果是 HTTP 網址，這是唯一可用的選項。

「網頁應用程式」頁面也可讓 IT 管理員編輯及刪除網頁應用程式。刪除網頁應用程式時會移除使用者的 Google Play 管理版商店中安裝在他們的裝置上。如要從使用者的裝置刪除網頁應用程式，請參閱刪除應用程式。操作說明支援建立和編輯網頁應用程式，請前往 Google Play 管理版說明中心。

選取按鈕

網頁應用程式發布後，詳細資料頁面會顯示一個 SELECT 按鈕。您需要指定 IT 管理員點選這個按鈕後發生的動作 (例如：發布應用程式) (請參閱 onproductselect：步驟 3：帳號代碼 iframe 事件)。

整理應用程式

IT 管理員可透過「整理應用程式」頁面，將應用程式整理成集合 (又稱為 clusters)。舉例來說，IT 管理員可以建立 Essentials 集合或支出收集 (用於追蹤支出) 相關應用程式；記錄旅遊行程等。集合會顯示在使用者裝置的 Play 商店首頁中。

EMM 必須使用在 iframe 網址的參數中加入 SELECT mode，以便搜尋及新增應用程式。

在使用者的裝置上，Play 商店應用程式只會顯示 Google 提供的系列應用程式使用者 (或裝置) 的行為。如果集合不含任何使用者可用的應用程式 (或裝置)，系列應用程式就不會顯示在 Play 商店中。

IT 管理員也可以在「整理應用程式」頁面中編輯、刪除及複製現有集合。使用者如要瞭解如何執行這些任務，請參閱 Google Play 管理版說明中心。

將 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 管理員選取、核准及取消核准應用程式。已淘汰：此模式已淘汰，請使用 `SELECT` 。 2025 年 9 月 30 日後，任何人都無法再使用這個方法。只有在 `PlaySearch.ApproveApps` 設為以下值時， `APPROVE` 模式才能正常運作網頁權杖中的 `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

使用者選取或核准應用程式。這樣會傳回包含以下內容的物件：

{
    "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);