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

app의 이름입니다(형식: enterprises/{enterprise}/applications/{package_name}).
title

string

앱 제목입니다. 현지화됩니다.
permissions[]

object (ApplicationPermission)

앱에 필요한 권한입니다.
managedProperties[]

object (ManagedProperty)

앱에 대해 사전 구성할 수 있는 관리 속성 집합입니다.
iconUrl

string

앱의 아이콘으로 사용할 수 있는 이미지의 링크입니다. 이 이미지는 최대 512x512 픽셀 크기로 사용하기에 적합합니다.
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일 이내)입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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

수정할 수 없는 고유 트랙 식별자로, 앱의 트랙 정보를 표시하는 Play Console 페이지의 URL에 있는 releaseTrackId에서 가져옵니다.
trackAlias

string

Play Console에서 설정된 trackId와 연결된 트랙 이름입니다. 이름은 Play Console에서 수정할 수 있습니다.

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -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이면 이 버전이 프로덕션 트랙임을 나타냅니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌