MCP Tools Reference: Android Device Management MCP Server

Ferramenta: get_application

Recebe detalhes do aplicativo para uma determinada empresa e ID do aplicativo. Exige o nome do recurso no formato: enterprises/{enterpriseId}/applications/{applicationId}.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta get_application MCP.

Solicitação 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
}'

Esquema de entrada

Solicitação para receber informações sobre um aplicativo.

GetApplicationRequest

Representação JSON 
{
  "name": string,
  "languageCode": string
}
Campos
name

string

O nome do aplicativo no formato enterprises/{enterpriseId}/applications/{package_name}.
languageCode

string

O idioma preferido para informações localizadas do aplicativo, como uma tag BCP47 (por exemplo, "en-US", "de"). Se não for especificado, o idioma padrão do aplicativo será usado.

Esquema de saída

Informações sobre um app.

Aplicativo

Representação 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
}
Campos
name

string

O nome do app no formato enterprises/{enterprise}/applications/{package_name}.
title

string

O título do app. Localizado.
permissions[]

object (ApplicationPermission)

As permissões necessárias para o app.
managedProperties[]

object (ManagedProperty)

O conjunto de propriedades gerenciadas disponíveis para pré-configuração do app.
iconUrl

string

Um link para uma imagem que pode ser usada como ícone do app. Essa imagem é adequada para uso até um tamanho de pixel de 512 x 512.
smallIconUrl

string

Um link para uma imagem menor que pode ser usada como um ícone para o app. Essa imagem é adequada para uso até um tamanho de pixel de 128 x 128.
appTracks[]

object (AppTrackInfo)

Rastreamentos de aplicativos visíveis para a empresa.
author

string

O nome do autor dos apps (por exemplo, o desenvolvedor de apps).
playStoreUrl

string

Um link para a página de detalhes do app no Google Play (para consumidores).
distributionChannel

enum (DistributionChannel)

Como e para quem o pacote é disponibilizado.
appPricing

enum (AppPricing)

Se o app é sem custo financeiro, sem custo financeiro com compras no app ou pago. Se o preço não for especificado, isso significa que o app não está mais disponível para o público em geral, mesmo que ainda esteja disponível para quem o possui.
description

string

A descrição promocional localizada, se disponível.
screenshotUrls[]

string

Uma lista de links de capturas de tela que representam o app.
category

string

A categoria do app (por exemplo, RACING, SOCIAL etc.)
recentChanges

string

Uma descrição localizada das mudanças recentes feitas no app.
minAndroidSdkVersion

integer

O SDK mínimo do Android necessário para executar o app.
contentRating

enum (ContentRating)

A classificação do conteúdo deste app.
updateTime

string (Timestamp format)

Apenas saída. O tempo aproximado (em até 7 dias) da última publicação do app.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
availableCountries[]

string

Os países em que o app está disponível, de acordo com a norma ISO 3166-1 alfa-2.
features[]

enum (AppFeature)

Recursos importantes (se houver) deste app.
appVersions[]

object (AppVersion)

Versões disponíveis no momento para este app.
fullDescription

string

Descrição completa do app, se disponível.

ApplicationPermission

Representação JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
Campos
permissionId

string

Uma string opaca que identifica exclusivamente a permissão. Não localizado.
name

string

O nome da permissão. Localizado.
description

string

Uma descrição mais longa da permissão, com mais detalhes sobre o que ela afeta. Localizado.

ManagedProperty

Representação JSON 
{
  "key": string,
  "type": enum (ManagedPropertyType),
  "title": string,
  "description": string,
  "entries": [
    {
      object (ManagedPropertyEntry)
    }
  ],
  "defaultValue": value,
  "nestedProperties": [
    {
      object (ManagedProperty)
    }
  ]
}
Campos
key

string

A chave exclusiva que o app usa para identificar a propriedade, por exemplo, "com.google.android.gm.fieldname".
type

enum (ManagedPropertyType)

O tipo da propriedade.
title

string

O nome da propriedade. Localizado.
description

string

Uma descrição mais longa da propriedade, fornecendo mais detalhes sobre o que ela afeta. Localizado.
entries[]

object (ManagedPropertyEntry)

Para propriedades CHOICE ou MULTISELECT, a lista de entradas possíveis.
defaultValue

value (Value format)

O valor padrão da propriedade. As propriedades BUNDLE_ARRAY não têm um valor padrão.
nestedProperties[]

object (ManagedProperty)

Para propriedades BUNDLE_ARRAY, a lista de propriedades aninhadas. Uma propriedade BUNDLE_ARRAY tem no máximo dois níveis de profundidade.

ManagedPropertyEntry

Representação JSON 
{
  "value": string,
  "name": string
}
Campos
value

string

O valor legível por máquina da entrada, que deve ser usado na configuração. Não localizado.
name

string

O nome legível do valor. Localizado.

Valor

Representação 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.
}
Campos
Campo de união kind. O tipo de valor. kind pode ser apenas de um dos tipos a seguir:
nullValue

null

Representa um valor nulo.
numberValue

number

Representa um valor double.
stringValue

string

Representa um valor de string.
boolValue

boolean

Representa um valor booleano.
structValue

object (Struct format)

Representa um valor estruturado.
listValue

array (ListValue format)

Representa um Value repetido.

Struct

Representação JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

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

Mapa não ordenado de valores com tipagem dinâmica.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representação JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

ListValue

Representação JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Campo repetido de valores digitados dinamicamente.

AppTrackInfo

Representação JSON 
{
  "trackId": string,
  "trackAlias": string
}
Campos
trackId

string

O identificador exclusivo e imutável da faixa, extraído do releaseTrackId no URL da página do Play Console que mostra as informações da faixa do app.
trackAlias

string

O nome da faixa associada ao trackId, definido no Play Console. O nome pode ser modificado no Play Console.

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa estar entre 0 e 999.999.999 (inclusive).

AppVersion

Representação JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Campos
versionString

string

A string usada na Play Store pelo desenvolvedor do app para identificar a versão. A string não é necessariamente exclusiva ou localizada (por exemplo, a string pode ser "1.4").
versionCode

integer

Identificador exclusivo e crescente da versão do app.
trackIds[]

string

Rastrear identificadores em que a versão do app é publicada. Isso não inclui a faixa de produção. Consulte "Produção".
production

boolean

Se o valor for "True", isso indica que a versão é uma faixa de produção.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌