MCP Tools Reference: Android Device Management MCP Server

Tool: get_application

Ruft Anwendungsdetails für ein bestimmtes Unternehmen und eine bestimmte Anwendungs-ID ab. Erfordert den Ressourcennamen im Format „enterprises/{enterpriseId}/applications/{applicationId}“.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool get_application aufrufen.

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

Eingabeschema

Anfrage zum Abrufen von Informationen zu einer Anwendung.

GetApplicationRequest

JSON-Darstellung
{
  "name": string,
  "languageCode": string
}
Felder
name

string

Der Name der Anwendung im Format enterprises/{enterpriseId}/applications/{package_name}.

languageCode

string

Die bevorzugte Sprache für lokalisierte Anwendungsinformationen als BCP47-Tag (z.B. „en-US“, „de“). Wenn nichts angegeben ist, wird die Standardsprache der Anwendung verwendet.

Ausgabeschema

Informationen zu einer App.

Anwendung

JSON-Darstellung
{
  "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
}
Felder
name

string

Der Name der App im Format „enterprises/{enterprise}/applications/{package_name}“.

title

string

Der Titel der App. Lokalisiert.

permissions[]

object (ApplicationPermission)

Die von der App benötigten Berechtigungen.

managedProperties[]

object (ManagedProperty)

Die Menge der verwalteten Eigenschaften, die für die App vorkonfiguriert werden können.

iconUrl

string

Ein Link zu einem Bild, das als Symbol für die App verwendet werden kann. Dieses Bild eignet sich für eine Pixelgröße von bis zu 512 × 512.

smallIconUrl

string

Ein Link zu einem kleineren Bild, das als Symbol für die App verwendet werden kann. Dieses Bild eignet sich für eine Pixelgröße von bis zu 128 × 128.

appTracks[]

object (AppTrackInfo)

Für das Unternehmen sichtbare Anwendungs-Tracks.

author

string

Der Name des Autors der Apps, z. B. des App-Entwicklers.

playStoreUrl

string

Ein Link zur (Consumer-)Google Play-Detailseite der App.

distributionChannel

enum (DistributionChannel)

Wie und wem das Paket zur Verfügung gestellt wird.

appPricing

enum (AppPricing)

Ob diese App kostenlos, kostenlos mit In-App-Käufen oder kostenpflichtig ist. Wenn die Preise nicht angegeben sind, ist die App nicht mehr allgemein verfügbar, auch wenn sie für Nutzer, die sie besitzen, möglicherweise weiterhin verfügbar ist.

description

string

Die lokalisierte Angebotsbeschreibung, falls verfügbar.

screenshotUrls[]

string

Eine Liste mit Screenshot-Links, die die App darstellen.

category

string

Die App-Kategorie (z.B. RACING, SOCIAL usw.)

recentChanges

string

Eine lokalisierte Beschreibung der letzten Änderungen an der App.

minAndroidSdkVersion

integer

Das für die Ausführung der App erforderliche minimale Android-SDK.

contentRating

enum (ContentRating)

Die Altersfreigabe für diese App.

updateTime

string (Timestamp format)

Nur Ausgabe. Der ungefähre Zeitpunkt (innerhalb von 7 Tagen), zu dem die App zuletzt veröffentlicht wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

availableCountries[]

string

Die Länder, in denen diese App gemäß ISO 3166-1 Alpha-2 verfügbar ist.

features[]

enum (AppFeature)

Besondere Funktionen dieser App (falls vorhanden).

appVersions[]

object (AppVersion)

Versionen, die derzeit für diese App verfügbar sind.

fullDescription

string

Vollständige App-Beschreibung, falls verfügbar.

ApplicationPermission

JSON-Darstellung
{
  "permissionId": string,
  "name": string,
  "description": string
}
Felder
permissionId

string

Ein nicht durchsichtiger String, der die Berechtigung eindeutig identifiziert. Nicht lokalisiert.

name

string

Der Name der Berechtigung. Lokalisiert.

description

string

Eine längere Beschreibung der Berechtigung, die mehr Details dazu enthält, was sie betrifft. Lokalisiert.

ManagedProperty

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

string

Der eindeutige Schlüssel, mit dem die App die Property identifiziert, z.B. „com.google.android.gm.fieldname“.

type

enum (ManagedPropertyType)

Der Typ der Immobilie.

title

string

Der Name der Unterkunft. Lokalisiert.

description

string

Eine längere Beschreibung der Property, die mehr Details dazu enthält, was sie betrifft. Lokalisiert.

entries[]

object (ManagedPropertyEntry)

Für CHOICE- oder MULTISELECT-Properties die Liste der möglichen Einträge.

defaultValue

value (Value format)

Der Standardwert der Property. BUNDLE_ARRAY-Properties haben keinen Standardwert.

nestedProperties[]

object (ManagedProperty)

Für BUNDLE_ARRAY-Properties die Liste der verschachtelten Properties. Eine BUNDLE_ARRAY-Property hat maximal zwei Ebenen.

ManagedPropertyEntry

JSON-Darstellung
{
  "value": string,
  "name": string
}
Felder
value

string

Der maschinenlesbare Wert des Eintrags, der in der Konfiguration verwendet werden sollte. Nicht lokalisiert.

name

string

Der für Menschen lesbare Name des Werts. Lokalisiert.

Wert

JSON-Darstellung
{

  // 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.
}
Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue

null

Stellt einen Nullwert dar.

numberValue

number

Stellt einen Double-Wert dar.

stringValue

string

Stellt einen Stringwert dar.

boolValue

boolean

Stellt einen booleschen Wert dar.

structValue

object (Struct format)

Stellt einen strukturierten Wert dar.

listValue

array (ListValue format)

Stellt eine wiederholte Value dar.

Struct

JSON-Darstellung
{
  "fields": {
    string: value,
    ...
  }
}
Felder
fields

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

Ungeordnete Zuordnung von dynamisch typisierten Werten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-Darstellung
{
  "key": string,
  "value": value
}
Felder
key

string

value

value (Value format)

ListValue

JSON-Darstellung
{
  "values": [
    value
  ]
}
Felder
values[]

value (Value format)

Wiederholtes Feld mit dynamisch typisierten Werten.

AppTrackInfo

JSON-Darstellung
{
  "trackId": string,
  "trackAlias": string
}
Felder
trackId

string

Die unveränderliche eindeutige Track-ID aus dem releaseTrackId in der URL der Play Console-Seite, auf der die Track-Informationen der App angezeigt werden.

trackAlias

string

Der mit dem trackId verknüpfte Trackname, der in der Play Console festgelegt ist. Der Name kann in der Play Console geändert werden.

Zeitstempel

JSON-Darstellung
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).

nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

AppVersion

JSON-Darstellung
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Felder
versionString

string

Die Zeichenfolge, die vom App-Entwickler im Play Store verwendet wird, um die Version zu identifizieren. Der String muss nicht unbedingt eindeutig oder lokalisiert sein (z. B. könnte der String „1.4“ lauten).

versionCode

integer

Eindeutige, fortlaufende Kennung für die App-Version.

trackIds[]

string

Tracking-IDs, in denen die App-Version veröffentlicht wird. Der Produktions-Track ist nicht enthalten (siehe „Produktion“).

production

boolean

Wenn der Wert „True“ ist, gibt dies an, dass diese Version ein Produktions-Track ist.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌