MCP Tools Reference: Android Device Management MCP Server

Инструмент: get_application

Получает подробные сведения о приложении для заданного предприятия и идентификатора приложения. Требуется имя ресурса в формате: enterprises/{enterpriseId}/applications/{applicationId}.

В следующем примере показано, как использовать curl для вызова инструмента MCP get_application .

Запрос 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

Полное описание приложения, если оно доступно.

Разрешение приложения

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

Представляет собой значение типа 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" } .

Ввод полей

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

Неизменяемый уникальный идентификатор трека, взятый из параметра releaseTrackId в URL-адресе страницы Play Console, отображающей информацию о треке приложения.

trackAlias

string

Название трека, связанное с trackId , заданным в консоли Play Console. Название можно изменить в консоли Play Console.

Отметка времени

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 включительно.

Версия приложения

JSON-представление 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Поля
versionString

string

Строка, используемая разработчиком приложения в магазине Play Store для идентификации версии. Эта строка не обязательно уникальна или локализована (например, строка может быть "1.4").

versionCode

integer

Уникальный возрастающий идентификатор версии приложения.

trackIds[]

string

Идентификаторы отслеживания, в которых опубликована версия приложения. Сюда не входит производственная версия (см. вместо этого производственную версию).

production

boolean

Если значение равно True, это означает, что данная версия является производственной.

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌