MCP Tools Reference: Android Device Management MCP Server

工具：get_application

取得特定企業和應用程式 ID 的應用程式詳細資料。資源名稱的格式必須為 enterprises/{enterpriseId}/applications/{applicationId}。

以下範例示範如何使用 curl 叫用 get_application MCP 工具。

Curl 要求 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_application",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

輸入內容的結構定義

要求取得應用程式的相關資訊。

GetApplicationRequest

JSON 表示法 
{
  "name": string,
  "languageCode": string
}
欄位
name

string

應用程式名稱，格式為 enterprises/{enterpriseId}/applications/{package_name}。
languageCode

string

本地化應用程式資訊的偏好語言，以 BCP47 標記表示 (例如「en-US」、「de」)。如未指定，系統會使用應用程式的預設語言。

輸出內容的結構定義

應用程式資訊。

應用程式

JSON 表示法 
{
  "name": string,
  "title": string,
  "permissions": [
    {
      object (ApplicationPermission)
    }
  ],
  "managedProperties": [
    {
      object (ManagedProperty)
    }
  ],
  "iconUrl": string,
  "smallIconUrl": string,
  "appTracks": [
    {
      object (AppTrackInfo)
    }
  ],
  "author": string,
  "playStoreUrl": string,
  "distributionChannel": enum (DistributionChannel),
  "appPricing": enum (AppPricing),
  "description": string,
  "screenshotUrls": [
    string
  ],
  "category": string,
  "recentChanges": string,
  "minAndroidSdkVersion": integer,
  "contentRating": enum (ContentRating),
  "updateTime": string,
  "availableCountries": [
    string
  ],
  "features": [
    enum (AppFeature)
  ],
  "appVersions": [
    {
      object (AppVersion)
    }
  ],
  "fullDescription": string
}
欄位
name

string

應用程式名稱，格式為 enterprises/{enterprise}/applications/{package_name}。
title

string

應用程式的名稱 (已本地化)。
permissions[]

object (ApplicationPermission)

應用程式所需的權限。
managedProperties[]

object (ManagedProperty)

可為應用程式預先設定的受管理屬性集。
iconUrl

string

可做為應用程式圖示的圖片連結。這張圖片適合用於像素大小最高 512 x 512 的圖示。
smallIconUrl

string

可做為應用程式圖示的較小圖片連結。這張圖片適合用於像素大小最高 128 x 128 的圖示。
appTracks[]

object (AppTrackInfo)

企業可查看的應用程式軌跡。
author

string

應用程式作者的名稱 (例如應用程式開發人員)。
playStoreUrl

string

應用程式的 (消費者) Google Play 詳細資料頁面連結。
distributionChannel

enum (DistributionChannel)

套件的提供方式和對象。
appPricing

enum (AppPricing)

這款應用程式是免費、免費但含應用程式內購，還是付費。如果價格未指定，表示應用程式已不再公開販售 (即使擁有者仍可使用)。
description

string

本地化的宣傳說明 (如有)。
screenshotUrls[]

string

代表應用程式的螢幕截圖連結清單。
category

string

應用程式類別 (例如「賽車」、「社群」等)
recentChanges

string

應用程式近期變更的本地化說明。
minAndroidSdkVersion

integer

執行應用程式所需的最低 Android SDK。
contentRating

enum (ContentRating)

這個應用程式的內容分級。
updateTime

string (Timestamp format)

僅供輸出。應用程式上次發布的大約時間 (7 天內)。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
availableCountries[]

string

應用程式可用的國家/地區 (採 ISO 3166-1 alpha-2 格式)。
features[]

enum (AppFeature)

這款應用程式的顯著功能 (如有)。
appVersions[]

object (AppVersion)

這個應用程式目前開放下載的版本。
fullDescription

string

完整的應用程式說明 (如有)。

ApplicationPermission

JSON 表示法 
{
  "permissionId": string,
  "name": string,
  "description": string
}
欄位
permissionId

string

用於唯一識別權限的不透明字串。未本地化。
name

string

權限名稱。本地化。
description

string

權限的詳細說明，提供更多影響相關資訊。本地化。

ManagedProperty

JSON 表示法 
{
  "key": string,
  "type": enum (ManagedPropertyType),
  "title": string,
  "description": string,
  "entries": [
    {
      object (ManagedPropertyEntry)
    }
  ],
  "defaultValue": value,
  "nestedProperties": [
    {
      object (ManagedProperty)
    }
  ]
}
欄位
key

string

應用程式用來識別資源的專屬鍵，例如「com.google.android.gm.fieldname」。
type

enum (ManagedPropertyType)

房源類型。
title

string

房源名稱。本地化。
description

string

房源的詳細說明，提供更多影響的詳細資料。本地化。
entries[]

object (ManagedPropertyEntry)

CHOICE 或 MULTISELECT 屬性的可能項目清單。
defaultValue

value (Value format)

屬性的預設值。BUNDLE_ARRAY 屬性沒有預設值。
nestedProperties[]

object (ManagedProperty)

如果是 BUNDLE_ARRAY 屬性，則為巢狀屬性清單。BUNDLE_ARRAY 屬性最多只能有兩層。

ManagedPropertyEntry

JSON 表示法 
{
  "value": string,
  "name": string
}
欄位
value

string

項目的機器可讀取值，應在設定中使用。未本地化。
name

string

使用者可解讀的值名稱。本地化。

值

JSON 表示法 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
欄位
聯集欄位 kind。值的類型。kind 只能是下列其中一項：
nullValue

null

表示空值。
numberValue

number

代表雙精度浮點數值。
stringValue

string

代表字串值。
boolValue

boolean

表示布林值。
structValue

object (Struct format)

代表結構化值。
listValue

array (ListValue format)

代表重複的 Value。

結構

JSON 表示法 
{
  "fields": {
    string: value,
    ...
  }
}
欄位
fields

map (key: string, value: value (Value format))

動態型別值的無序對應。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

FieldsEntry

JSON 表示法 
{
  "key": string,
  "value": value
}
欄位
key

string
value

value (Value format)

ListValue

JSON 表示法 
{
  "values": [
    value
  ]
}
欄位
values[]

value (Value format)

動態型別值的重複欄位。

AppTrackInfo

JSON 表示法 
{
  "trackId": string,
  "trackAlias": string
}
欄位
trackId

string

不可修改的專屬測試群組 ID，取自 Play 管理中心頁面網址中的 releaseTrackId，該頁面會顯示應用程式的測試群組資訊。
trackAlias

string

與 trackId 相關聯的測試群組名稱，在 Play 管理中心中設定。您可以在 Play 管理中心修改名稱。

時間戳記

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
欄位
seconds

string (int64 format)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含)，對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。
nanos

integer

以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分，並非秒數的替代值。如果秒數值為負數，且包含小數，奈秒值仍須為非負數，且會向前計時。必須介於 0 至 999,999,999 之間 (含)。

AppVersion

JSON 表示法 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
欄位
versionString

string

應用程式開發人員在 Play 商店中用來識別版本的字串。字串不一定會是專屬或本地化字串 (例如字串可以是「1.4」)。
versionCode

integer

應用程式版本的專屬遞增 ID。
trackIds[]

string

追蹤應用程式版本發布時使用的 ID。不包括正式版群組 (請參閱正式版)。
production

boolean

如果值為 True，表示這個版本是正式版。

工具註解

破壞性提示：❌ | 等冪提示：✅ | 唯讀提示：✅ | 開放世界提示：❌