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 }'

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”）的形式表示。如果未指定，则使用应用的默认语言。

name

string

应用名称，格式为 enterprises/{enterpriseId}/applications/{package_name}。

languageCode

string

本地化应用信息的首选语言，以 BCP47 标记（例如“en-US”“de”）的形式表示。如果未指定，则使用应用的默认语言。

输出架构

应用的相关信息。

应用

JSON 表示法

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,
  "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` 可作为应用图标的小尺寸图片的链接。此图片适合用作像素尺寸不超过 128x128 的图标。
`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 规范化（即转换为 UTC 零时区格式并在末尾附加 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` 权限的详细说明，提供有关其影响的更多详细信息。本地化。

permissionId

string

唯一标识权限的不透明字符串。未本地化。

name

string

权限的名称。本地化。

description

string

权限的详细说明，提供有关其影响的更多详细信息。本地化。

ManagedProperty

JSON 表示法

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

{
  "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` 值的直观易懂的名称。本地化。

value

string

条目的机器可读值，应在配置中使用。未本地化。

name

string

值的直观易懂的名称。本地化。

值

JSON 表示法

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`. }

{

  // 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` 表示 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" }`。

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)` 动态类型值的重复字段。

values[]

value (Value format)

动态类型值的重复字段。

AppTrackInfo

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

字段

字段
`trackId`	`string` 不可修改的唯一轨道标识符，取自 Play 管理中心页面网址（显示应用的轨道信息）中的 `releaseTrackId`。
`trackAlias`	`string` 与 `trackId` 关联的轨道名称，在 Play 管理中心内设置。您可以在 Play 管理中心内修改此名称。

trackId

string

不可修改的唯一轨道标识符，取自 Play 管理中心页面网址（显示应用的轨道信息）中的 releaseTrackId。

trackAlias

string

与 trackId 关联的轨道名称，在 Play 管理中心内设置。您可以在 Play 管理中心内修改此名称。

时间戳

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

字段

字段
`seconds`	`string (int64 format)` 表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。
`nanos`	`integer` 秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代项。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 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` 应用版本的唯一递增标识符。
`trackIds[]`	`string` 应用版本发布时所用的跟踪标识符。这不包括正式版轨道（请改为参阅正式版）。
`production`	`boolean` 如果值为 True，则表示相应版本是正式版轨道。

工具注释

破坏性提示：❌ | 等幂性提示：✅ | 只读提示：✅ | 开放世界提示：❌

MCP Tools Reference: Android Device Management MCP Server 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

工具：get_application

输入架构

GetApplicationRequest

输出架构

应用

ApplicationPermission

ManagedProperty

ManagedPropertyEntry

值

结构体

FieldsEntry

ListValue

AppTrackInfo

时间戳

AppVersion

工具注释

MCP Tools Reference: Android Device Management MCP Server

工具：`get_application`