MCP Tools Reference: Android Device Management MCP Server

Strumento: get_application

Recupera i dettagli dell'applicazione per un determinato ID applicazione e azienda. Richiede il nome della risorsa nel formato: enterprises/{enterpriseId}/applications/{applicationId}.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP get_application.

Curl Request 
                  
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
}'

Schema di input

Richiedi informazioni su un'applicazione.

GetApplicationRequest

Rappresentazione JSON 
{
  "name": string,
  "languageCode": string
}
Campi
name

string

Il nome dell'applicazione nel formato enterprises/{enterpriseId}/applications/{package_name}.
languageCode

string

La lingua preferita per le informazioni sull'applicazione localizzate, come tag BCP47 (ad es. "en-US", "de"). Se non specificata, verrà utilizzata la lingua predefinita dell'applicazione.

Schema di output

Informazioni su un'app.

Applicazione

Rappresentazione 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
}
Campi
name

string

Il nome dell'app nel formato enterprises/{enterprise}/applications/{package_name}.
title

string

Il titolo dell'app. Localizzato.
permissions[]

object (ApplicationPermission)

Le autorizzazioni richieste dall'app.
managedProperties[]

object (ManagedProperty)

Il set di proprietà gestite disponibili per la preconfigurazione dell'app.
iconUrl

string

Un link a un'immagine che può essere utilizzata come icona per l'app. Questa immagine è adatta per l'utilizzo fino a una dimensione di 512 x 512 pixel.
smallIconUrl

string

Un link a un'immagine più piccola che può essere utilizzata come icona per l'app. Questa immagine è adatta per l'utilizzo fino a una dimensione di 128 x 128 pixel.
appTracks[]

object (AppTrackInfo)

Tracce delle applicazioni visibili all'azienda.
author

string

Il nome dell'autore delle app (ad esempio lo sviluppatore dell'app).
playStoreUrl

string

Un link alla pagina dei dettagli di Google Play (consumer) dell'app.
distributionChannel

enum (DistributionChannel)

Come e a chi viene reso disponibile il pacchetto.
appPricing

enum (AppPricing)

Se l'app è senza costi, senza costi con acquisti in-app o a pagamento. Se il prezzo non è specificato, significa che l'app non è più disponibile al pubblico (anche se potrebbe essere ancora disponibile per chi la possiede).
description

string

La descrizione promozionale localizzata, se disponibile.
screenshotUrls[]

string

Un elenco di link agli screenshot che rappresentano l'app.
category

string

La categoria dell'app (ad es. CORSE, SOCIAL e così via)
recentChanges

string

Una descrizione localizzata delle modifiche recenti apportate all'app.
minAndroidSdkVersion

integer

L'SDK Android minimo necessario per eseguire l'app.
contentRating

enum (ContentRating)

La classificazione dei contenuti di questa app.
updateTime

string (Timestamp format)

Solo output. L'ora approssimativa (entro 7 giorni) dell'ultima pubblicazione dell'app.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
availableCountries[]

string

I paesi in cui è disponibile questa app secondo lo standard ISO 3166-1 alpha-2.
features[]

enum (AppFeature)

Funzionalità degne di nota (se presenti) di questa app.
appVersions[]

object (AppVersion)

Versioni attualmente disponibili per questa app.
fullDescription

string

Descrizione completa dell'app, se disponibile.

ApplicationPermission

Rappresentazione JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
Campi
permissionId

string

Una stringa opaca che identifica in modo univoco l'autorizzazione. Non localizzato.
name

string

Il nome dell'autorizzazione. Localizzato.
description

string

Una descrizione più lunga dell'autorizzazione, che fornisce maggiori dettagli su cosa influisce. Localizzato.

ManagedProperty

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

string

La chiave univoca utilizzata dall'app per identificare la proprietà, ad esempio "com.google.android.gm.fieldname".
type

enum (ManagedPropertyType)

Il tipo di proprietà.
title

string

Il nome della proprietà. Localizzato.
description

string

Una descrizione più lunga della proprietà, che fornisce maggiori dettagli su ciò che influenza. Localizzato.
entries[]

object (ManagedPropertyEntry)

Per le proprietà CHOICE o MULTISELECT, l'elenco delle voci possibili.
defaultValue

value (Value format)

Il valore predefinito della proprietà. Le proprietà BUNDLE_ARRAY non hanno un valore predefinito.
nestedProperties[]

object (ManagedProperty)

Per le proprietà BUNDLE_ARRAY, l'elenco delle proprietà nidificate. Una proprietà BUNDLE_ARRAY ha al massimo due livelli di profondità.

ManagedPropertyEntry

Rappresentazione JSON 
{
  "value": string,
  "name": string
}
Campi
value

string

Il valore leggibile dalla macchina della voce, che deve essere utilizzato nella configurazione. Non localizzato.
name

string

Il nome leggibile del valore. Localizzato.

Valore

Rappresentazione 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.
}
Campi
Campo unione kind. Il tipo di valore. kind può essere solo uno dei seguenti tipi:
nullValue

null

Rappresenta un valore null.
numberValue

number

Rappresenta un valore doppio.
stringValue

string

Rappresenta un valore stringa.
boolValue

boolean

Rappresenta un valore booleano.
structValue

object (Struct format)

Rappresenta un valore strutturato.
listValue

array (ListValue format)

Rappresenta un Value ripetuto.

Struct

Rappresentazione JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campi
fields

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

Mappa non ordinata di valori digitati dinamicamente.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": value
}
Campi
key

string
value

value (Value format)

ListValue

Rappresentazione JSON 
{
  "values": [
    value
  ]
}
Campi
values[]

value (Value format)

Campo ripetuto di valori con tipo dinamico.

AppTrackInfo

Rappresentazione JSON 
{
  "trackId": string,
  "trackAlias": string
}
Campi
trackId

string

L'identificatore univoco della traccia non modificabile, tratto da releaseTrackId nell'URL della pagina di Play Console che mostra le informazioni sulla traccia dell'app.
trackAlias

string

Il nome della traccia associata a trackId, impostato in Play Console. Il nome è modificabile da Play Console.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi di tempo UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

AppVersion

Rappresentazione JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Campi
versionString

string

La stringa utilizzata nel Play Store dallo sviluppatore dell'app per identificare la versione. La stringa non è necessariamente univoca o localizzata (ad esempio, la stringa potrebbe essere "1.4").
versionCode

integer

Identificatore univoco crescente per la versione dell'app.
trackIds[]

string

Monitora gli identificatori in cui viene pubblicata la versione dell'app. Non è incluso il canale di produzione (vedi invece la produzione).
production

boolean

Se il valore è True, indica che questa versione è una traccia di produzione.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌