透過 Google Play 管理版 iframe,您可以在 EMM 控制台中直接嵌入 Google Play 管理版,為客戶提供整合式行動管理體驗。
iframe 包含標題列和可展開的側邊選單。使用者可以透過選單前往不同頁面:
- 搜尋應用程式:允許 IT 管理員搜尋及瀏覽 Google Play 應用程式、查看應用程式詳細資料及選取應用程式。
- 私人應用程式:允許 IT 管理員發布及管理所屬企業的私人應用程式。
- 網頁應用程式:允許 IT 管理員以應用程式的形式發布及發布網站捷徑。
- 整理應用程式:允許 IT 管理員設定如何在使用者裝置上的 Play 商店應用程式中整理應用程式。
所有頁面都會預設為在 iframe 中啟用,但您也可以個別停用 (請參閱「在主控台中新增 iframe」一節)。
功能與特色
本節將說明 Google Play 管理版 iframe 的功能。如要瞭解如何嵌入 iframe 並實作這些功能,請參閱「將 iframe 新增至主控台」一文。
在控制台中新增 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
以下範例說明如何轉譯 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 標記的屬性。
網址參數
下表列出 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。只有當網頁權杖中的 PlaySearch.ApproveApps 設為 true 時,核准模式才能正常運作。 |
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
|
onproductselect
:
iframe.register('onproductselect', function(event) { console.log(event); }, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);