MCP Tools Reference: Android Device Management MCP Server

Narzędzie: get_application

Pobiera szczegóły aplikacji dla danej firmy i identyfikatora aplikacji. Wymaga nazwy zasobu w formacie: enterprises/{enterpriseId}/applications/{applicationId}.

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie get_application MCP.

Żądanie 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
}'

Schemat wejściowy

Prośba o informacje o aplikacji.

GetApplicationRequest

Zapis JSON 
{
  "name": string,
  "languageCode": string
}
Pola
name

string

Nazwa aplikacji w formacie enterprises/{enterpriseId}/applications/{package_name}.
languageCode

string

Preferowany język zlokalizowanych informacji o aplikacji w formacie BCP47 (np. „en-US”, „de”). Jeśli nie zostanie określony, użyty zostanie domyślny język aplikacji.

Schemat wyjściowy

Informacje o aplikacji.

Aplikacja

Zapis 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
}
Pola
name

string

Nazwa aplikacji w formacie enterprises/{enterprise}/applications/{package_name}.
title

string

Tytuł aplikacji. Zlokalizowany.
permissions[]

object (ApplicationPermission)

Uprawnienia wymagane przez aplikację.
managedProperties[]

object (ManagedProperty)

Zestaw właściwości zarządzanych, które można wstępnie skonfigurować dla aplikacji.
iconUrl

string

Link do obrazu, który może być używany jako ikona aplikacji. Ten obraz nadaje się do użycia w rozmiarze do 512 x 512 pikseli.
smallIconUrl

string

Link do mniejszego obrazu, który może być używany jako ikona aplikacji. Ten obraz nadaje się do użycia w rozmiarze do 128 x 128 pikseli.
appTracks[]

object (AppTrackInfo)

Ścieżki aplikacji widoczne dla firmy.
author

string

Imię i nazwisko autora aplikacji (np. dewelopera).
playStoreUrl

string

Link do strony z informacjami o aplikacji w Google Play (wersja dla konsumentów).
distributionChannel

enum (DistributionChannel)

Jak i komu pakiet jest udostępniany.
appPricing

enum (AppPricing)

Czy aplikacja jest bezpłatna, bezpłatna z opcją zakupów w aplikacji czy płatna. Jeśli cena nie jest określona, oznacza to, że aplikacja nie jest już ogólnie dostępna (chociaż może być nadal dostępna dla osób, które ją mają).
description

string

Zlokalizowany opis promocyjny, jeśli jest dostępny.
screenshotUrls[]

string

Lista linków do zrzutów ekranu przedstawiających aplikację.
category

string

kategoria aplikacji (np. RACING, SOCIAL itp.);
recentChanges

string

Zlokalizowany opis ostatnich zmian wprowadzonych w aplikacji.
minAndroidSdkVersion

integer

Minimalny pakiet SDK na Androida niezbędny do uruchomienia aplikacji.
contentRating

enum (ContentRating)

Ocena treści tej aplikacji.
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Przybliżony czas (w ciągu 7 dni) ostatniego opublikowania aplikacji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
availableCountries[]

string

Kraje, w których ta aplikacja jest dostępna, zgodnie ze standardem ISO 3166-1 alfa-2.
features[]

enum (AppFeature)

Ważne funkcje tej aplikacji (jeśli takie są).
appVersions[]

object (AppVersion)

Wersje aktualnie dostępne dla tej aplikacji.
fullDescription

string

Pełny opis aplikacji (jeśli jest dostępny).

ApplicationPermission

Zapis JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
Pola
permissionId

string

Nieczytelny ciąg znaków jednoznacznie identyfikujący uprawnienie. Nie jest zlokalizowana.
name

string

Nazwa uprawnienia. Zlokalizowany.
description

string

Dłuższy opis uprawnień, zawierający więcej szczegółów na temat tego, na co wpływają. Zlokalizowany.

ManagedProperty

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

string

Unikalny klucz, którego aplikacja używa do identyfikowania usługi, np. „com.google.android.gm.fieldname”.
type

enum (ManagedPropertyType)

Typ nieruchomości.
title

string

Nazwa usługi. Zlokalizowany.
description

string

Dłuższy opis właściwości, zawierający więcej szczegółów na temat tego, na co wpływa. Zlokalizowany.
entries[]

object (ManagedPropertyEntry)

W przypadku właściwości CHOICE lub MULTISELECT lista możliwych wpisów.
defaultValue

value (Value format)

Wartość domyślna właściwości. Właściwości BUNDLE_ARRAY nie mają wartości domyślnej.
nestedProperties[]

object (ManagedProperty)

W przypadku właściwości BUNDLE_ARRAY lista właściwości zagnieżdżonych. Usługa BUNDLE_ARRAY może mieć maksymalnie 2 poziomy.

ManagedPropertyEntry

Zapis JSON 
{
  "value": string,
  "name": string
}
Pola
value

string

Wartość wpisu, którą można odczytać maszynowo i której należy używać w konfiguracji. Nie jest zlokalizowana.
name

string

Czytelna nazwa wartości. Zlokalizowany.

Wartość

Zapis 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.
}
Pola
Pole zbiorcze kind. Rodzaj wartości. kind może mieć tylko jedną z tych wartości:
nullValue

null

Reprezentuje wartość null.
numberValue

number

Reprezentuje wartość typu double.
stringValue

string

Reprezentuje wartość ciągu tekstowego.
boolValue

boolean

Reprezentuje wartość logiczną.
structValue

object (Struct format)

Reprezentuje wartość strukturalną.
listValue

array (ListValue format)

Oznacza powtórzone Value.

Struct

Zapis JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Pola
fields

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

Nieuporządkowana mapa wartości o typie dynamicznym.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

Zapis JSON 
{
  "key": string,
  "value": value
}
Pola
key

string
value

value (Value format)

ListValue

Zapis JSON 
{
  "values": [
    value
  ]
}
Pola
values[]

value (Value format)

Powtórzone pole wartości o dynamicznym typie.

AppTrackInfo

Zapis JSON 
{
  "trackId": string,
  "trackAlias": string
}
Pola
trackId

string

Niemodyfikowalny, niepowtarzalny identyfikator ścieżki pobrany z parametru releaseTrackId w adresie URL strony Konsoli Play, na której wyświetlają się informacje o ścieżce aplikacji.
trackAlias

string

Nazwa wersji powiązanej z trackId, ustawiona w Konsoli Play. Nazwę można zmienić w Konsoli Play.

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w przedziale od -62135596800 do 253402300799 (włącznie), co odpowiada zakresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z.
nanos

integer

Nieujemne ułamki sekundy w rozdzielczości nanosekundowej. To pole zawiera część czasu trwania w nanosekundach, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami muszą mieć nieujemne wartości nanosekund, które liczą czas do przodu. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

AppVersion

Zapis JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Pola
versionString

string

Ciąg znaków używany w Sklepie Play przez dewelopera aplikacji do identyfikacji wersji. Ciąg znaków nie musi być niepowtarzalny ani zlokalizowany (np. może to być „1.4”).
versionCode

integer

Unikalny identyfikator wersji aplikacji, który rośnie.
trackIds[]

string

Śledź identyfikatory, w których opublikowana jest wersja aplikacji. Nie obejmuje to ścieżki produkcyjnej (zobacz produkcję).
production

boolean

Jeśli wartość to „True”, oznacza to, że ta wersja jest ścieżką produkcyjną.

Adnotacje do narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌