MCP Tools Reference: Android Device Management MCP Server

Herramienta: get_application

Obtiene los detalles de la aplicación para una empresa y un ID de aplicación determinados. Requiere el nombre del recurso en el formato enterprises/{enterpriseId}/applications/{applicationId}.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP get_application.

Solicitud de 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

Es una solicitud para obtener información sobre una aplicación.

GetApplicationRequest

Representación JSON 
{
  "name": string,
  "languageCode": string
}
Campos
name

string

Nombre de la aplicación en el formato enterprises/{enterpriseId}/applications/{package_name}.
languageCode

string

Idioma preferido para la información de la aplicación localizada, como una etiqueta BCP47 (p.ej., "en-US", "de"). Si no se especifica, se usará el idioma predeterminado de la aplicación.

Esquema de salida

Es información sobre una app.

Aplicación

Representación 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

Nombre de la app con el formato enterprises/{enterprise}/applications/{package_name}.
title

string

Es el título de la app, localizado.
permissions[]

object (ApplicationPermission)

Son los permisos que requiere la app.
managedProperties[]

object (ManagedProperty)

Es el conjunto de propiedades administradas que se pueden preconfigurar para la app.
iconUrl

string

Es un vínculo a una imagen que se puede usar como ícono de la app. Esta imagen es adecuada para usarse hasta un tamaño de píxeles de 512 x 512.
smallIconUrl

string

Es un vínculo a una imagen más pequeña que se puede usar como ícono de la app. Esta imagen es adecuada para usarse hasta un tamaño de píxeles de 128 x 128.
appTracks[]

object (AppTrackInfo)

Son los segmentos de la aplicación visibles para la empresa.
author

string

Es el nombre del autor de las apps (por ejemplo, el desarrollador de la app).
playStoreUrl

string

Es un vínculo a la página de detalles de Google Play (para el consumidor) de la app.
distributionChannel

enum (DistributionChannel)

Cómo y a quién se pone a disposición el paquete.
appPricing

enum (AppPricing)

Indica si la app es gratuita, gratuita con compras directas desde la app o pagada. Si no se especifica el precio, significa que la app ya no está disponible de forma general (aunque es posible que siga disponible para las personas que la tienen).
description

string

Es la descripción promocional localizada, si está disponible.
screenshotUrls[]

string

Es una lista de vínculos a capturas de pantalla que representan la app.
category

string

Categoría de la app (p.ej., CARRERAS, SOCIAL, etc.)
recentChanges

string

Es una descripción localizada de los cambios recientes que se realizaron en la app.
minAndroidSdkVersion

integer

Es el SDK de Android mínimo necesario para ejecutar la app.
contentRating

enum (ContentRating)

Es la clasificación del contenido de esta app.
updateTime

string (Timestamp format)

Solo salida. Es la fecha y hora aproximadas (en un plazo de 7 días) en que se publicó la app por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
availableCountries[]

string

Países en los que está disponible esta app según la norma ISO 3166-1 alfa-2.
features[]

enum (AppFeature)

Funciones destacadas (si las hay) de esta app.
appVersions[]

object (AppVersion)

Son las versiones disponibles actualmente para esta app.
fullDescription

string

Descripción completa de la app, si está disponible

ApplicationPermission

Representación JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
Campos
permissionId

string

Es una cadena opaca que identifica de forma única el permiso. No está localizada.
name

string

Es el nombre del permiso. Localizada.
description

string

Es una descripción más larga del permiso que proporciona más detalles sobre lo que afecta. Localizada.

ManagedProperty

Representación JSON 
{
  "key": string,
  "type": enum (ManagedPropertyType),
  "title": string,
  "description": string,
  "entries": [
    {
      object (ManagedPropertyEntry)
    }
  ],
  "defaultValue": value,
  "nestedProperties": [
    {
      object (ManagedProperty)
    }
  ]
}
Campos
key

string

Es la clave única que usa la app para identificar la propiedad, p.ej., "com.google.android.gm.fieldname".
type

enum (ManagedPropertyType)

Es el tipo de propiedad.
title

string

Es el nombre de la propiedad. Localizada.
description

string

Es una descripción más larga de la propiedad que proporciona más detalles sobre lo que afecta. Localizada.
entries[]

object (ManagedPropertyEntry)

Para las propiedades CHOICE o MULTISELECT, es la lista de entradas posibles.
defaultValue

value (Value format)

Es el valor predeterminado de la propiedad. Las propiedades BUNDLE_ARRAY no tienen un valor predeterminado.
nestedProperties[]

object (ManagedProperty)

Para las propiedades BUNDLE_ARRAY, es la lista de propiedades anidadas. Una propiedad BUNDLE_ARRAY tiene como máximo dos niveles de profundidad.

ManagedPropertyEntry

Representación JSON 
{
  "value": string,
  "name": string
}
Campos
value

string

Es el valor legible por máquina de la entrada, que se debe usar en la configuración. No está localizada.
name

string

Es el nombre legible del valor. Localizada.

Valor

Representación 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ón kind. Es el tipo de valor. kind puede ser solo uno de los parámetros siguientes:
nullValue

null

Representa un valor nulo.
numberValue

number

Representa un valor doble.
stringValue

string

Representa un valor de cadena.
boolValue

boolean

Representa un valor booleano.
structValue

object (Struct format)

Representa un valor estructurado.
listValue

array (ListValue format)

Representa un Value repetido.

Struct

Representación JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

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

Es un mapa no ordenado de valores escritos de forma dinámica.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representación JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

ListValue

Representación JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Es un campo repetido de valores escritos de forma dinámica.

AppTrackInfo

Representación JSON 
{
  "trackId": string,
  "trackAlias": string
}
Campos
trackId

string

Es el identificador único y no modificable del segmento, que se toma de releaseTrackId en la URL de la página de Play Console que muestra la información del segmento de la app.
trackAlias

string

Es el nombre del segmento asociado con trackId, establecido en Play Console. El nombre se puede modificar desde Play Console.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de la duración en nanosegundos, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

AppVersion

Representación JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Campos
versionString

string

Es la cadena que usa el desarrollador de la app en Play Store para identificar la versión. La cadena no es necesariamente única ni está localizada (por ejemplo, la cadena podría ser "1.4").
versionCode

integer

Es un identificador único y creciente de la versión de la app.
trackIds[]

string

Son los identificadores de seguimiento en los que se publica la versión de la app. No incluye el segmento de producción (consulta producción en su lugar).
production

boolean

Si el valor es verdadero, indica que esta versión es un segmento de producción.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌