重要資訊:我們目前不接受新的 Play EMM API 註冊。
瞭解詳情。
Webapps
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源表示法
WebApps 資源代表專為企業建立的網頁應用程式,網頁應用程式會發布至 Google Play 管理版,也可以像其他 Android 應用程式一樣發布。在使用者的裝置上,網頁應用程式會開啟指定網址。
{
"webAppId": string,
"title": string,
"startUrl": string,
"icons": [
{
"imageData": string
}
],
"displayMode": string,
"versionCode": long,
"isPublished": boolean
}
屬性名稱 |
值 |
說明 |
附註 |
displayMode |
string |
網頁應用程式的顯示模式。
可能的值包括:- 「
minimalUi 」,應用程式開啟時,裝置會顯示狀態列、導覽列、應用程式網址和重新整理按鈕。如果是 HTTP 網址,只能選取這個選項。 - 「
standalone 」,應用程式開啟時,系統會顯示裝置的狀態列和導覽列。 - 「
fullScreen 」:應用程式會以全螢幕模式開啟,並隱藏裝置的狀態和導覽列。所有瀏覽器 UI 元素、網頁網址、系統狀態列和返回按鈕都無法顯示,網頁應用程式會佔滿整個可用的顯示區域。 ,瞭解如何調查及移除這項存取權。
可接受的值為:
- 「
fullScreen 」
- 「
minimalUi 」
- 「
standalone 」
|
|
icons[] |
list |
代表這個網站的圖示清單。如未指定,系統會使用預設圖示 (用於建立) 或目前的圖示 (用於更新)。 |
|
icons[].imageData |
string |
在 Base64url 編碼字串 (c.f. RFC4648 第 5 節)「Base 64 Encoding with URL 和 Filename Safe Alphabet」中,圖片的實際位元組。 - 圖片類型可以是 png 或 jpg。
- 圖片最好是正方形。
- 最好為 512x512 的圖片。
|
|
isPublished |
boolean |
標記應用程式是否已發布至 Play 商店。 |
|
startUrl |
string |
起始網址,亦即使用者開啟應用程式時應載入的網址。 |
|
title |
string |
向使用者顯示的網頁應用程式名稱 (例如其他應用程式清單或圖示的標籤)。 |
|
versionCode |
long |
應用程式的目前版本。
請注意,網頁應用程式的生命週期內可能會自動增加版本,但 Google 內部會進行內部作業,確保網頁應用程式保持在最新狀態。 |
|
webAppId |
string |
應用程式的 ID。格式為 "app:<package name>" 的字串,其中套件名稱一律開頭為 "com.google.enterprise.webapp." ,後面加上隨機 ID。 |
|
方法
- 刪除
- 刪除現有的網頁應用程式。
- 取得
- 取得現有的網頁應用程式。
- 插入
- 為企業建立新的網頁應用程式。
- list
- 擷取特定企業所有網頁應用程式的詳細資料。
- 更新
- 更新現有的網頁應用程式。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-10 (世界標準時間)。
[null,null,["上次更新時間:2024-09-10 (世界標準時間)。"],[[["\u003cp\u003eWebApps resources represent web apps published to managed Google Play and distributed like other Android apps, opening a specified URL on the user's device.\u003c/p\u003e\n"],["\u003cp\u003eWeb apps have properties like \u003ccode\u003etitle\u003c/code\u003e, \u003ccode\u003estartUrl\u003c/code\u003e, \u003ccode\u003edisplayMode\u003c/code\u003e, and \u003ccode\u003eicons\u003c/code\u003e that define their behavior and appearance.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage web apps using methods like \u003ccode\u003einsert\u003c/code\u003e, \u003ccode\u003eget\u003c/code\u003e, \u003ccode\u003eupdate\u003c/code\u003e, \u003ccode\u003edelete\u003c/code\u003e, and \u003ccode\u003elist\u003c/code\u003e to create, retrieve, modify, and remove them.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ewebAppId\u003c/code\u003e is a unique identifier for each web app, following the format \u003ccode\u003e"app:<package name>"\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eversionCode\u003c/code\u003e represents the current version of the app and may increase automatically for internal updates.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n\nA WebApps resource represents a web app created for an enterprise. Web apps are published to managed Google Play and can be distributed like other Android apps. On a user's device, a web app opens its specified URL.\n\n```text\n{\n \"webAppId\": string,\n \"title\": string,\n \"startUrl\": string,\n \"icons\": [\n {\n \"imageData\": string\n }\n ],\n \"displayMode\": string,\n \"versionCode\": long,\n \"isPublished\": boolean\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `displayMode` | `string` | The display mode of the web app. Possible values include: - \"`minimalUi`\", the device's status bar, navigation bar, the app's URL, and a refresh button are visible when the app is open. For HTTP URLs, you can only select this option. - \"`standalone`\", the device's status bar and navigation bar are visible when the app is open. - \"`fullScreen`\", the app opens in full screen mode, hiding the device's status and navigation bars. All browser UI elements, page URL, system status bar and back button are not visible, and the web app takes up the entirety of the available display area. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`fullScreen`\" - \"`minimalUi`\" - \"`standalone`\" | |\n| `icons[]` | `list` | A list of icons representing this website. If absent, a default icon (for create) or the current icon (for update) will be used. | |\n| icons[].`imageData` | `string` | The actual bytes of the image in a base64url encoded string (c.f. RFC4648, section 5 \"Base 64 Encoding with URL and Filename Safe Alphabet\"). - The image type can be png or jpg. - The image should ideally be square. - The image should ideally have a size of 512x512. | |\n| `isPublished` | `boolean` | A flag whether the app has been published to the Play store yet. | |\n| `startUrl` | `string` | The start URL, i.e. the URL that should load when the user opens the application. | |\n| `title` | `string` | The title of the web app as displayed to the user (e.g., amongst a list of other applications, or as a label for an icon). | |\n| `versionCode` | `long` | The current version of the app. Note that the version can automatically increase during the lifetime of the web app, while Google does internal housekeeping to keep the web app up-to-date. | |\n| `webAppId` | `string` | The ID of the application. A string of the form `\"app:\u003cpackage name\u003e\"` where the package name always starts with the prefix `\"com.google.enterprise.webapp.\"` followed by a random id. | |\n\nMethods\n\n[delete](/android/work/play/emm-api/v1/webapps/delete)\n: Deletes an existing web app.\n\n[get](/android/work/play/emm-api/v1/webapps/get)\n: Gets an existing web app.\n\n[insert](/android/work/play/emm-api/v1/webapps/insert)\n: Creates a new web app for the enterprise.\n\n[list](/android/work/play/emm-api/v1/webapps/list)\n: Retrieves the details of all web apps for a given enterprise.\n\n[update](/android/work/play/emm-api/v1/webapps/update)\n: Updates an existing web app."]]