MCP Tools Reference: Android Device Management MCP Server

Outil : get_application

Récupère les détails d'une application pour une entreprise et un ID d'application donnés. Nécessite le nom de ressource au format enterprises/{enterpriseId}/applications/{applicationId}.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP get_application.

Requête 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
}'

Schéma d'entrée

Requête permettant d'obtenir des informations sur une application.

GetApplicationRequest

Représentation JSON 
{
  "name": string,
  "languageCode": string
}
Champs
name

string

Nom de l'application au format enterprises/{enterpriseId}/applications/{package_name}.
languageCode

string

Langue préférée pour les informations localisées sur l'application, sous forme de tag BCP47 (par exemple, "en-US" ou "de"). Si aucune valeur n'est spécifiée, la langue par défaut de l'application sera utilisée.

Schéma de sortie

Informations sur une application.

Application

Représentation 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
}
Champs
name

string

Nom de l'application au format enterprises/{enterprise}/applications/{package_name}.
title

string

Titre de l'application. Localisé.
permissions[]

object (ApplicationPermission)

Autorisations requises par l'application.
managedProperties[]

object (ManagedProperty)

Ensemble de propriétés gérées pouvant être préconfigurées pour l'application.
iconUrl

string

Lien vers une image pouvant servir d'icône pour l'application. Cette image peut être utilisée jusqu'à une taille de 512 x 512 pixels.
smallIconUrl

string

Lien vers une image plus petite pouvant être utilisée comme icône pour l'application. Cette image peut être utilisée jusqu'à une taille de 128 x 128 pixels.
appTracks[]

object (AppTrackInfo)

Pistes d'application visibles par l'entreprise.
author

string

Nom de l'auteur des applications (par exemple, le développeur de l'application).
playStoreUrl

string

Lien vers la page d'informations (grand public) Google Play de l'application.
distributionChannel

enum (DistributionChannel)

Comment et à qui le package est mis à disposition.
appPricing

enum (AppPricing)

Indique si l'application est sans frais, sans frais avec des achats via l'application ou payante. Si le prix n'est pas spécifié, cela signifie que l'application n'est plus disponible au grand public (même si elle peut encore l'être pour les personnes qui la possèdent).
description

string

Description promotionnelle localisée, si disponible.
screenshotUrls[]

string

Liste des liens vers des captures d'écran représentant l'application.
category

string

Catégorie de l'application (par exemple, COURSE, SOCIAL, etc.)
recentChanges

string

Description localisée des modifications récentes apportées à l'application.
minAndroidSdkVersion

integer

Version minimale du SDK Android nécessaire pour exécuter l'application.
contentRating

enum (ContentRating)

Classification du contenu de cette application.
updateTime

string (Timestamp format)

Uniquement en sortie. Heure approximative (dans les sept derniers jours) à laquelle l'application a été publiée pour la dernière fois.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
availableCountries[]

string

Pays dans lesquels cette application est disponible, conformément à la norme ISO 3166-1 alpha-2.
features[]

enum (AppFeature)

Fonctionnalités notables (le cas échéant) de cette application.
appVersions[]

object (AppVersion)

Versions actuellement disponibles pour cette application.
fullDescription

string

Description complète de l'application, si disponible.

ApplicationPermission

Représentation JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
Champs
permissionId

string

Chaîne opaque identifiant de manière unique l'autorisation. Non localisé.
name

string

Nom de l'autorisation. Localisé.
description

string

Description plus longue de l'autorisation, fournissant plus de détails sur ce qu'elle affecte. Localisé.

ManagedProperty

Représentation JSON 
{
  "key": string,
  "type": enum (ManagedPropertyType),
  "title": string,
  "description": string,
  "entries": [
    {
      object (ManagedPropertyEntry)
    }
  ],
  "defaultValue": value,
  "nestedProperties": [
    {
      object (ManagedProperty)
    }
  ]
}
Champs
key

string

Clé unique utilisée par l'application pour identifier la propriété (par exemple, "com.google.android.gm.fieldname").
type

enum (ManagedPropertyType)

Type de propriété.
title

string

Nom de la propriété. Localisé.
description

string

Description plus longue de la propriété, fournissant plus de détails sur ce qu'elle affecte. Localisé.
entries[]

object (ManagedPropertyEntry)

Pour les propriétés CHOICE ou MULTISELECT, la liste des entrées possibles.
defaultValue

value (Value format)

Valeur par défaut de la propriété. Les propriétés BUNDLE_ARRAY n'ont pas de valeur par défaut.
nestedProperties[]

object (ManagedProperty)

Pour les propriétés BUNDLE_ARRAY, liste des propriétés imbriquées. Une propriété BUNDLE_ARRAY ne peut pas dépasser deux niveaux de profondeur.

ManagedPropertyEntry

Représentation JSON 
{
  "value": string,
  "name": string
}
Champs
value

string

Valeur de l'entrée lisible par la machine, à utiliser dans la configuration. Non localisé.
name

string

Nom de la valeur dans un format lisible. Localisé.

Valeur

Représentation 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.
}
Champs
Champ d'union kind. Type de valeur. kind ne peut être qu'un des éléments suivants :
nullValue

null

Représente une valeur nulle.
numberValue

number

Représente une valeur double.
stringValue

string

Représente une valeur de chaîne.
boolValue

boolean

Représente une valeur booléenne.
structValue

object (Struct format)

Représente une valeur structurée.
listValue

array (ListValue format)

Représente un Value répété.

Struct

Représentation JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Champs
fields

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

Carte non ordonnée de valeurs typées de manière dynamique.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Représentation JSON 
{
  "key": string,
  "value": value
}
Champs
key

string
value

value (Value format)

ListValue

Représentation JSON 
{
  "values": [
    value
  ]
}
Champs
values[]

value (Value format)

Champ répété de valeurs typées de manière dynamique.

AppTrackInfo

Représentation JSON 
{
  "trackId": string,
  "trackAlias": string
}
Champs
trackId

string

Identifiant unique non modifiable de la piste, extrait de releaseTrackId dans l'URL de la page de la Play Console qui affiche les informations sur la piste de l'application.
trackAlias

string

Nom de la version associé à trackId, défini dans la Play Console. Vous pouvez modifier le nom dans la Play Console.

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.

AppVersion

Représentation JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Champs
versionString

string

Chaîne utilisée dans le Play Store par le développeur de l'application pour identifier la version. La chaîne n'est pas nécessairement unique ni localisée (par exemple, elle peut être "1.4").
versionCode

integer

Identifiant unique et croissant pour la version de l'application.
trackIds[]

string

Suivez les identifiants de piste dans lesquels la version de l'application est publiée. Cela n'inclut pas le canal de production (voir "Production").
production

boolean

Si la valeur est "True", cela indique que cette version est une piste de production.

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌