MCP Tools Reference: Android Device Management MCP Server

Araç: get_application

Belirli bir kuruluş ve uygulama kimliği için uygulama ayrıntılarını alır. Kaynak adının şu biçimde olması gerekir: enterprises/{enterpriseId}/applications/{applicationId}.

Aşağıdaki örnekte, curl kullanılarak get_application MCP aracının nasıl çağrılacağı gösterilmektedir.

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

Giriş Şeması

Uygulama hakkında bilgi edinme isteği

GetApplicationRequest

JSON gösterimi 
{
  "name": string,
  "languageCode": string
}
Alanlar
name

string

Uygulamanın adı (enterprises/{enterpriseId}/applications/{package_name} biçiminde).
languageCode

string

Yerelleştirilmiş uygulama bilgileri için tercih edilen dil, BCP47 etiketi olarak (ör. "en-US", "de"). Belirtilmezse uygulamanın varsayılan dili kullanılır.

Çıkış Şeması

Uygulama hakkında bilgiler.

Uygulama

JSON gösterimi 
{
  "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
}
Alanlar
name

string

Uygulamanın adı (ör. enterprises/{enterprise}/applications/{package_name}).
title

string

Uygulamanın başlığı. Yerelleştirilmiş.
permissions[]

object (ApplicationPermission)

Uygulamanın gerektirdiği izinler.
managedProperties[]

object (ManagedProperty)

Uygulama için önceden yapılandırılabilen yönetilen özellikler kümesi.
iconUrl

string

Uygulama simgesi olarak kullanılabilecek bir resmin bağlantısı. Bu resim, 512 x 512 piksel boyutuna kadar kullanıma uygundur.
smallIconUrl

string

Uygulama için simge olarak kullanılabilecek daha küçük bir resmin bağlantısı. Bu resim, 128 x 128 piksel boyutuna kadar kullanıma uygundur.
appTracks[]

object (AppTrackInfo)

Uygulama izleri, kuruluşa görünür.
author

string

Uygulamaların yazarının adı (ör. uygulama geliştiricisi).
playStoreUrl

string

Uygulamanın (tüketici) Google Play ayrıntılar sayfasına bağlantı.
distributionChannel

enum (DistributionChannel)

Paketin nasıl ve kimlere sunulduğu.
appPricing

enum (AppPricing)

Uygulamanın ücretsiz, uygulama içi satın alma olanağı sunan ücretsiz veya ücretli olup olmadığı Fiyatlandırma belirtilmemişse bu, uygulamanın artık genel olarak kullanılamadığı anlamına gelir (sahip olan kişiler uygulamayı kullanmaya devam edebilir).
description

string

Varsa yerelleştirilmiş promosyon açıklaması.
screenshotUrls[]

string

Uygulamayı temsil eden ekran görüntüsü bağlantılarının listesi.
category

string

Uygulama kategorisi (ör. YARIŞ, SOSYAL vb.)
recentChanges

string

Uygulamada yapılan son değişikliklerin yerelleştirilmiş açıklaması.
minAndroidSdkVersion

integer

Uygulamayı çalıştırmak için gereken minimum Android SDK.
contentRating

enum (ContentRating)

Bu uygulamanın içerik derecelendirmesi.
updateTime

string (Timestamp format)

Yalnızca çıkış. Uygulamanın son yayınlandığı yaklaşık süre (7 gün içinde).

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
availableCountries[]

string

Bu uygulamanın ISO 3166-1 alfa-2'ye göre kullanılabildiği ülkeler.
features[]

enum (AppFeature)

Bu uygulamanın önemli özellikleri (varsa).
appVersions[]

object (AppVersion)

Bu uygulama için şu anda indirilebilecek sürümler.
fullDescription

string

Varsa uygulamanın tam açıklaması.

ApplicationPermission

JSON gösterimi 
{
  "permissionId": string,
  "name": string,
  "description": string
}
Alanlar
permissionId

string

İzni benzersiz şekilde tanımlayan opak bir dize. Yerelleştirilmemiş.
name

string

İznin adı. Yerelleştirilmiş.
description

string

İznin daha uzun bir açıklaması. Bu açıklamada, iznin neleri etkilediğiyle ilgili daha fazla ayrıntı verilir. Yerelleştirilmiş.

ManagedProperty

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

string

Uygulamanın mülkü tanımlamak için kullandığı benzersiz anahtar (ör. "com.google.android.gm.fieldname").
type

enum (ManagedPropertyType)

Mülkün türü.
title

string

Tesisin adı. Yerelleştirilmiş.
description

string

Tesisin daha uzun bir açıklaması. Bu açıklama, sorunun etkilediği alanlarla ilgili daha fazla ayrıntı sağlar. Yerelleştirilmiş.
entries[]

object (ManagedPropertyEntry)

CHOICE veya MULTISELECT özellikleri için olası girişlerin listesi.
defaultValue

value (Value format)

Özelliğin varsayılan değeri. BUNDLE_ARRAY özelliklerinin varsayılan değeri yoktur.
nestedProperties[]

object (ManagedProperty)

BUNDLE_ARRAY özellikleri için iç içe yerleştirilmiş özelliklerin listesi. Bir BUNDLE_ARRAY özelliği en fazla iki düzey derinliğinde olabilir.

ManagedPropertyEntry

JSON gösterimi 
{
  "value": string,
  "name": string
}
Alanlar
value

string

Girişin makine tarafından okunabilir değeri, yapılandırmada kullanılmalıdır. Yerelleştirilmemiş.
name

string

Değerin kullanıcılar tarafından okunabilir adı. Yerelleştirilmiş.

Değer

JSON gösterimi 
{

  // 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.
}
Alanlar
kind birleşik alanı. Değer türü. kind aşağıdakilerden yalnızca biri olabilir:
nullValue

null

Boş değeri temsil eder.
numberValue

number

Çift değeri temsil eder.
stringValue

string

Bir dize değerini temsil eder.
boolValue

boolean

Boole değerini gösterir.
structValue

object (Struct format)

Yapılandırılmış bir değeri temsil eder.
listValue

array (ListValue format)

Tekrarlanan Value öğesini temsil eder.

Struct

JSON gösterimi 
{
  "fields": {
    string: value,
    ...
  }
}
Alanlar
fields

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

Dinamik olarak türü belirlenmiş değerlerin sırasız haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON gösterimi 
{
  "key": string,
  "value": value
}
Alanlar
key

string
value

value (Value format)

ListValue

JSON gösterimi 
{
  "values": [
    value
  ]
}
Alanlar
values[]

value (Value format)

Dinamik olarak türü belirlenen değerlerin tekrar eden alanı.

AppTrackInfo

JSON gösterimi 
{
  "trackId": string,
  "trackAlias": string
}
Alanlar
trackId

string

Uygulamanın parça bilgilerini gösteren Play Console sayfasının URL'sindeki releaseTrackId bölümünden alınan, değiştirilemeyen benzersiz parça tanımlayıcısı.
trackAlias

string

Play Console'da ayarlanan trackId ile ilişkili kanal adı. Ad, Play Console'dan değiştirilebilir.

Zaman damgası

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Unix sıfır zamanı 1970-01-01T00:00:00Z'den itibaren UTC zamanının saniyelerini gösterir. -62135596800 ile 253402300799 arasında olmalıdır (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir).
nanos

integer

Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, sürenin nanosaniye kısmıdır ve saniyenin alternatifi değildir. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında olmalıdır (bu değerler dahil).

AppVersion

JSON gösterimi 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Alanlar
versionString

string

Play Store'da uygulama geliştirici tarafından sürümü tanımlamak için kullanılan dize. Dize benzersiz veya yerelleştirilmiş olmak zorunda değildir (örneğin, dize "1.4" olabilir).
versionCode

integer

Uygulama sürümünün benzersiz artan tanımlayıcısı.
trackIds[]

string

Uygulama sürümünün yayınlandığı izleme tanımlayıcıları. Üretim kanalı bu kapsamda değildir (bunun yerine üretime bakın).
production

boolean

Değer True ise bu sürümün üretim kanalı olduğu anlaşılır.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌