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

アプリのカテゴリ(RACING、SOCIAL など)。

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 プロパティの深さは最大 2 レベルです。

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

null 値を表します。

numberValue

number

double 値を表します。

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。アプリのトラック情報を表示する Google Play Console ページの URL の releaseTrackId から取得されます。

trackAlias

string

trackId に関連付けられているトラック名。Google Play Console で設定します。名前は Google Play Console から変更できます。

タイムスタンプ

JSON 表現
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800~253402300799 の範囲(両端を含む)にする必要があります(これは 0001-01-01T00:00:00Z~9999-12-31T23:59:59Z に対応します)。

nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0~999,999,999 にする必要があります(両端を含む)。

AppVersion

JSON 表現
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
フィールド
versionString

string

アプリのデベロッパーが Google Play ストアでバージョンを識別するために使用する文字列。文字列は必ずしも一意である必要はなく、ローカライズされている必要もありません(たとえば、文字列は「1.4」などになります)。

versionCode

integer

アプリ バージョンの固有の増加識別子。

trackIds[]

string

アプリのバージョンが公開されているトラックの ID。これには、製品版トラックは含まれません(製品版を参照)。

production

boolean

値が True の場合、このバージョンが製品版トラックであることを示します。

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌