MCP Tools Reference: Android Device Management MCP Server

Alat: get_application

Mendapatkan detail aplikasi untuk ID aplikasi dan perusahaan tertentu. Memerlukan nama resource dalam format: enterprises/{enterpriseId}/applications/{applicationId}.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP get_application.

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

Skema Input

Permintaan untuk mendapatkan info tentang aplikasi.

GetApplicationRequest

Representasi JSON 
{
  "name": string,
  "languageCode": string
}
Kolom
name

string

Nama aplikasi dalam bentuk enterprises/{enterpriseId}/applications/{package_name}.
languageCode

string

Bahasa pilihan untuk info aplikasi yang dilokalkan, sebagai tag BCP47 (misalnya, "en-US", "de"). Jika tidak ditentukan, bahasa default aplikasi akan digunakan.

Skema Output

Informasi tentang aplikasi.

Aplikasi

Representasi 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
}
Kolom
name

string

Nama aplikasi dalam bentuk enterprises/{enterprise}/applications/{package_name}.
title

string

Judul aplikasi. Dilokalkan.
permissions[]

object (ApplicationPermission)

Izin yang diperlukan oleh aplikasi.
managedProperties[]

object (ManagedProperty)

Kumpulan properti terkelola yang tersedia untuk dikonfigurasi sebelumnya untuk aplikasi.
iconUrl

string

Link ke gambar yang dapat digunakan sebagai ikon untuk aplikasi. Gambar ini cocok untuk digunakan hingga ukuran piksel 512 x 512.
smallIconUrl

string

Link ke gambar yang lebih kecil yang dapat digunakan sebagai ikon untuk aplikasi. Gambar ini cocok untuk digunakan hingga ukuran piksel 128 x 128.
appTracks[]

object (AppTrackInfo)

Jalur aplikasi yang terlihat oleh perusahaan.
author

string

Nama penulis aplikasi (misalnya, developer aplikasi).
playStoreUrl

string

Link ke halaman detail Google Play (konsumen) untuk aplikasi.
distributionChannel

enum (DistributionChannel)

Cara dan kepada siapa paket tersebut tersedia.
appPricing

enum (AppPricing)

Apakah aplikasi ini gratis, gratis dengan pembelian dalam aplikasi, atau berbayar. Jika harga tidak ditentukan, artinya aplikasi tidak lagi tersedia secara umum (meskipun mungkin masih tersedia untuk orang yang memilikinya).
description

string

Deskripsi promosi yang dilokalkan, jika tersedia.
screenshotUrls[]

string

Daftar link screenshot yang merepresentasikan aplikasi.
category

string

Kategori aplikasi (misalnya, BALAP, SOSIAL, dll.)
recentChanges

string

Deskripsi yang dilokalkan untuk perubahan terbaru yang dilakukan pada aplikasi.
minAndroidSdkVersion

integer

SDK Android minimum yang diperlukan untuk menjalankan aplikasi.
contentRating

enum (ContentRating)

Rating konten untuk aplikasi ini.
updateTime

string (Timestamp format)

Hanya output. Perkiraan waktu (dalam 7 hari) aplikasi terakhir kali dipublikasikan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
availableCountries[]

string

Negara tempat aplikasi ini tersedia sesuai dengan ISO 3166-1 alpha-2.
features[]

enum (AppFeature)

Fitur penting (jika ada) dari aplikasi ini.
appVersions[]

object (AppVersion)

Versi yang saat ini tersedia untuk aplikasi ini.
fullDescription

string

Deskripsi lengkap aplikasi, jika tersedia.

ApplicationPermission

Representasi JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
Kolom
permissionId

string

String buram yang secara unik mengidentifikasi izin. Tidak dilokalkan.
name

string

Nama izin. Dilokalkan.
description

string

Deskripsi izin yang lebih panjang, yang memberikan detail lebih lanjut tentang apa yang terpengaruh. Dilokalkan.

ManagedProperty

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

string

Kunci unik yang digunakan aplikasi untuk mengidentifikasi properti, misalnya, "com.google.android.gm.fieldname".
type

enum (ManagedPropertyType)

Jenis properti.
title

string

Nama properti. Dilokalkan.
description

string

Deskripsi properti yang lebih panjang, yang memberikan detail lebih lanjut tentang apa yang terpengaruh. Dilokalkan.
entries[]

object (ManagedPropertyEntry)

Untuk properti CHOICE atau MULTISELECT, daftar kemungkinan entri.
defaultValue

value (Value format)

Nilai default properti. Properti BUNDLE_ARRAY tidak memiliki nilai default.
nestedProperties[]

object (ManagedProperty)

Untuk properti BUNDLE_ARRAY, daftar properti bertingkat. Properti BUNDLE_ARRAY memiliki kedalaman paling banyak dua tingkat.

ManagedPropertyEntry

Representasi JSON 
{
  "value": string,
  "name": string
}
Kolom
value

string

Nilai entri yang dapat dibaca mesin, yang harus digunakan dalam konfigurasi. Tidak dilokalkan.
name

string

Nama nilai yang dapat dibaca manusia. Dilokalkan.

Nilai

Representasi 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.
}
Kolom
Kolom union kind. Jenis nilai. kind hanya dapat berupa salah satu dari berikut:
nullValue

null

Mewakili nilai null.
numberValue

number

Mewakili nilai ganda.
stringValue

string

Mewakili nilai string.
boolValue

boolean

Mewakili nilai boolean.
structValue

object (Struct format)

Mewakili nilai terstruktur.
listValue

array (ListValue format)

Merepresentasikan Value yang berulang.

Struct

Representasi JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Kolom
fields

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

Peta tidak berurutan dari nilai yang diketik secara dinamis.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representasi JSON 
{
  "key": string,
  "value": value
}
Kolom
key

string
value

value (Value format)

ListValue

Representasi JSON 
{
  "values": [
    value
  ]
}
Kolom
values[]

value (Value format)

Kolom berulang dari nilai yang diketik secara dinamis.

AppTrackInfo

Representasi JSON 
{
  "trackId": string,
  "trackAlias": string
}
Kolom
trackId

string

ID jalur unik yang tidak dapat diubah, diambil dari releaseTrackId di URL halaman Konsol Play yang menampilkan informasi jalur aplikasi.
trackAlias

string

Nama jalur yang terkait dengan trackId, ditetapkan di Konsol Play. Nama dapat diubah dari Konsol Play.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

AppVersion

Representasi JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
Kolom
versionString

string

String yang digunakan di Play Store oleh developer aplikasi untuk mengidentifikasi versi. String tidak harus unik atau dilokalkan (misalnya, string dapat berupa "1.4").
versionCode

integer

ID unik yang terus bertambah untuk versi aplikasi.
trackIds[]

string

Melacak ID tempat versi aplikasi dipublikasikan. Ini tidak mencakup jalur produksi (lihat produksi).
production

boolean

Jika nilainya adalah True, ini menunjukkan bahwa versi ini adalah jalur produksi.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌