MCP Tools Reference: Android Device Management MCP Server

Công cụ: get_application

Lấy thông tin chi tiết về ứng dụng cho một doanh nghiệp và mã ứng dụng nhất định. Yêu cầu tên tài nguyên ở định dạng: enterprises/{enterpriseId}/applications/{applicationId}.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ get_application MCP.

Yêu cầu 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
}'

Giản đồ đầu vào

Yêu cầu nhận thông tin về một ứng dụng.

GetApplicationRequest

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "languageCode": string
}
Trường
name

string

Tên của ứng dụng ở dạng enterprises/{enterpriseId}/applications/{package_name}.
languageCode

string

Ngôn ngữ ưu tiên cho thông tin ứng dụng được bản địa hoá, dưới dạng thẻ BCP47 (ví dụ: "en-US", "de"). Nếu bạn không chỉ định, hệ thống sẽ sử dụng ngôn ngữ mặc định của ứng dụng.

Giản đồ đầu ra

Thông tin về một ứng dụng.

Ứng dụng

Biểu diễn dưới dạng 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
}
Trường
name

string

Tên của ứng dụng ở dạng enterprises/{enterprise}/applications/{package_name}.
title

string

Tiêu đề của ứng dụng. Đã bản địa hoá.
permissions[]

object (ApplicationPermission)

Các quyền mà ứng dụng yêu cầu.
managedProperties[]

object (ManagedProperty)

Tập hợp các thuộc tính được quản lý có thể được định cấu hình trước cho ứng dụng.
iconUrl

string

Đường liên kết đến một hình ảnh có thể dùng làm biểu tượng cho ứng dụng. Hình ảnh này phù hợp để sử dụng với kích thước tối đa là 512 x 512 pixel.
smallIconUrl

string

Đường liên kết đến một hình ảnh nhỏ hơn có thể dùng làm biểu tượng cho ứng dụng. Hình ảnh này phù hợp để sử dụng ở kích thước tối đa là 128 x 128 pixel.
appTracks[]

object (AppTrackInfo)

Doanh nghiệp có thể xem được thông tin theo dõi ứng dụng.
author

string

Tên tác giả của ứng dụng (ví dụ: nhà phát triển ứng dụng).
playStoreUrl

string

Đường liên kết đến trang chi tiết (dành cho người tiêu dùng) của Google Play cho ứng dụng.
distributionChannel

enum (DistributionChannel)

Cách thức và đối tượng mà gói được cung cấp.
appPricing

enum (AppPricing)

Ứng dụng này là miễn phí, miễn phí nhưng có tính năng mua hàng trong ứng dụng hay phải trả phí. Nếu giá không được chỉ định, điều này có nghĩa là ứng dụng không còn được cung cấp công khai nữa (mặc dù những người sở hữu ứng dụng vẫn có thể sử dụng).
description

string

Nội dung mô tả khuyến mãi được bản địa hoá (nếu có).
screenshotUrls[]

string

Danh sách các đường liên kết đến ảnh chụp màn hình đại diện cho ứng dụng.
category

string

Danh mục ứng dụng (ví dụ: ĐUA XE, MẠNG XÃ HỘI, v.v.)
recentChanges

string

Nội dung mô tả được bản địa hoá về những thay đổi gần đây đối với ứng dụng.
minAndroidSdkVersion

integer

SDK Android tối thiểu cần thiết để chạy ứng dụng.
contentRating

enum (ContentRating)

Mức phân loại nội dung của ứng dụng này.
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian gần đây nhất (trong vòng 7 ngày) ứng dụng được xuất bản (ước chừng).

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
availableCountries[]

string

Các quốc gia mà ứng dụng này có mặt theo tiêu chuẩn ISO 3166-1 alpha-2.
features[]

enum (AppFeature)

Các tính năng đáng chú ý (nếu có) của ứng dụng này.
appVersions[]

object (AppVersion)

Các phiên bản hiện có sẵn cho ứng dụng này.
fullDescription

string

Nội dung mô tả đầy đủ về ứng dụng (nếu có).

ApplicationPermission

Biểu diễn dưới dạng JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
Trường
permissionId

string

Một chuỗi mờ xác định duy nhất quyền. Không được bản địa hoá.
name

string

Tên của quyền. Đã bản địa hoá.
description

string

Nội dung mô tả dài hơn về quyền, cung cấp thông tin chi tiết hơn về những gì quyền này ảnh hưởng. Đã bản địa hoá.

ManagedProperty

Biểu diễn dưới dạng JSON 
{
  "key": string,
  "type": enum (ManagedPropertyType),
  "title": string,
  "description": string,
  "entries": [
    {
      object (ManagedPropertyEntry)
    }
  ],
  "defaultValue": value,
  "nestedProperties": [
    {
      object (ManagedProperty)
    }
  ]
}
Trường
key

string

Khoá duy nhất mà ứng dụng dùng để xác định tài sản, ví dụ: "com.google.android.gm.fieldname".
type

enum (ManagedPropertyType)

Loại cơ sở lưu trú.
title

string

Tên của cơ sở lưu trú. Đã bản địa hoá.
description

string

Nội dung mô tả dài hơn về thuộc tính, cung cấp thông tin chi tiết hơn về những gì thuộc tính đó ảnh hưởng. Đã bản địa hoá.
entries[]

object (ManagedPropertyEntry)

Đối với các thuộc tính CHOICE hoặc MULTISELECT, danh sách các mục có thể có.
defaultValue

value (Value format)

Giá trị mặc định của thuộc tính. Các thuộc tính BUNDLE_ARRAY không có giá trị mặc định.
nestedProperties[]

object (ManagedProperty)

Đối với các thuộc tính BUNDLE_ARRAY, danh sách các thuộc tính lồng nhau. Một tài sản BUNDLE_ARRAY có tối đa 2 cấp.

ManagedPropertyEntry

Biểu diễn dưới dạng JSON 
{
  "value": string,
  "name": string
}
Trường
value

string

Giá trị có thể đọc được bằng máy của mục nhập, cần được dùng trong cấu hình. Không được bản địa hoá.
name

string

Tên dễ đọc của giá trị. Đã bản địa hoá.

Giá trị

Biểu diễn dưới dạng 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.
}
Trường
Trường nhóm kind. Loại giá trị. kind chỉ có thể là một trong những trạng thái sau:
nullValue

null

Biểu thị một giá trị rỗng.
numberValue

number

Biểu thị một giá trị kiểu double.
stringValue

string

Biểu thị một giá trị chuỗi.
boolValue

boolean

Biểu thị một giá trị boolean.
structValue

object (Struct format)

Biểu thị một giá trị có cấu trúc.
listValue

array (ListValue format)

Đại diện cho một Value lặp lại.

Struct

Biểu diễn dưới dạng JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Trường
fields

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

Bản đồ không có thứ tự của các giá trị được nhập động.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Biểu diễn dưới dạng JSON 
{
  "key": string,
  "value": value
}
Trường
key

string
value

value (Value format)

ListValue

Biểu diễn dưới dạng JSON 
{
  "values": [
    value
  ]
}
Trường
values[]

value (Value format)

Trường lặp lại của các giá trị được nhập động.

AppTrackInfo

Biểu diễn dưới dạng JSON 
{
  "trackId": string,
  "trackAlias": string
}
Trường
trackId

string

Giá trị nhận dạng duy nhất của bản phát hành mà bạn không thể sửa đổi, lấy từ releaseTrackId trong URL của trang Play Console hiển thị thông tin về bản phát hành của ứng dụng.
trackAlias

string

Tên kênh liên kết với trackId, được thiết lập trong Play Console. Bạn có thể sửa đổi tên này trong Play Console.

Dấu thời gian

Biểu diễn dưới dạng JSON 
{
  "seconds": string,
  "nanos": integer
}
Trường
seconds

string (int64 format)

Biểu thị số giây theo giờ UTC kể từ thời gian bắt đầu của hệ thống Unix là 00:00:00 ngày 01/01/1970. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z).
nanos

integer

Phân số không âm của một giây ở độ phân giải nano giây. Trường này là phần nano giây của khoảng thời gian, chứ không phải là một lựa chọn thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

AppVersion

Biểu diễn dưới dạng JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Trường
versionString

string

Chuỗi mà nhà phát triển ứng dụng dùng trong Cửa hàng Play để xác định phiên bản. Chuỗi này không nhất thiết phải là duy nhất hoặc được bản địa hoá (ví dụ: chuỗi này có thể là "1.4").
versionCode

integer

Giá trị nhận dạng duy nhất tăng dần cho phiên bản ứng dụng.
trackIds[]

string

Theo dõi mã nhận dạng kênh mà phiên bản ứng dụng được xuất bản. Chỉ số này không bao gồm kênh phát hành công khai (xem kênh phát hành công khai).
production

boolean

Nếu giá trị là True, tức là phiên bản này thuộc kênh phát hành công khai.

Chú giải công cụ

Gợi ý mang tính phá hoại: ❌ | Gợi ý mang tính luỹ đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌