MCP Tools Reference: Android Device Management MCP Server

เครื่องมือ: get_application

รับรายละเอียดแอปพลิเคชันสำหรับองค์กรและรหัสแอปพลิเคชันที่ระบุ ต้องระบุชื่อทรัพยากรในรูปแบบ enterprises/{enterpriseId}/applications/{applicationId}

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ get_application MCP

คำขอ 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
}'

สคีมาอินพุต

ส่งคำขอเพื่อรับข้อมูลเกี่ยวกับแอปพลิเคชัน

GetApplicationRequest

การแสดง JSON 
{
  "name": string,
  "languageCode": string
}
ช่อง
name

string

ชื่อของแอปพลิเคชันในรูปแบบ enterprises/{enterpriseId}/applications/{package_name}
languageCode

string

ภาษาที่ต้องการสำหรับข้อมูลแอปพลิเคชันที่แปลแล้วเป็นแท็ก BCP47 (เช่น "en-US", "de") หากไม่ได้ระบุ ระบบจะใช้ภาษาเริ่มต้นของแอปพลิเคชัน

สคีมาเอาต์พุต

ข้อมูลเกี่ยวกับแอป

แอปพลิเคชัน

การแสดง 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
}
ช่อง
name

string

ชื่อของแอปในรูปแบบ enterprises/{enterprise}/applications/{package_name}
title

string

ชื่อแอปที่แปลแล้ว
permissions[]

object (ApplicationPermission)

สิทธิ์ที่แอปต้องใช้
managedProperties[]

object (ManagedProperty)

ชุดพร็อพเพอร์ตี้ที่มีการจัดการที่พร้อมให้กำหนดค่าล่วงหน้าสำหรับแอป
iconUrl

string

ลิงก์ไปยังรูปภาพที่ใช้เป็นไอคอนของแอปได้ รูปภาพนี้เหมาะสำหรับใช้กับขนาดสูงสุด 512 x 512 พิกเซล
smallIconUrl

string

ลิงก์ไปยังรูปภาพขนาดเล็กที่ใช้เป็นไอคอนสำหรับแอปได้ รูปภาพนี้เหมาะสำหรับใช้กับขนาดพิกเซลสูงสุด 128 x 128
appTracks[]

object (AppTrackInfo)

แอปพลิเคชันที่องค์กรเห็น
author

string

ชื่อผู้เขียนแอป (เช่น นักพัฒนาแอป)
playStoreUrl

string

ลิงก์ไปยังหน้ารายละเอียดของแอปใน Google Play (สำหรับผู้บริโภค)
distributionChannel

enum (DistributionChannel)

วิธีและผู้ที่สามารถเข้าถึงแพ็กเกจ
appPricing

enum (AppPricing)

แอปนี้เป็นแอปฟรี แอปฟรีที่มีการซื้อในแอป หรือแอปที่ต้องซื้อ หากไม่ได้ระบุราคาไว้ แสดงว่าโดยทั่วไปแล้วแอปจะไม่มีให้บริการอีกต่อไป (แม้ว่าแอปอาจยังคงพร้อมให้บริการแก่ผู้ที่เป็นเจ้าของ)
description

string

คำอธิบายโปรโมชันที่แปลแล้ว หากมี
screenshotUrls[]

string

รายการลิงก์ภาพหน้าจอที่แสดงถึงแอป
category

string

หมวดหมู่แอป (เช่น การแข่งรถ โซเชียล ฯลฯ)
recentChanges

string

คำอธิบายที่แปลแล้วของการเปลี่ยนแปลงล่าสุดที่เกิดขึ้นกับแอป
minAndroidSdkVersion

integer

SDK ขั้นต่ำของ Android ที่จำเป็นในการเรียกใช้แอป
contentRating

enum (ContentRating)

การจัดประเภทเนื้อหาสำหรับแอปนี้
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาโดยประมาณ (ภายใน 7 วัน) ที่เผยแพร่แอปครั้งล่าสุด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
availableCountries[]

string

ประเทศที่แอปนี้พร้อมให้บริการตามมาตรฐาน ISO 3166-1 alpha-2
features[]

enum (AppFeature)

ฟีเจอร์ที่น่าสนใจ (หากมี) ของแอปนี้
appVersions[]

object (AppVersion)

เวอร์ชันที่พร้อมใช้งานสำหรับแอปนี้ในขณะนี้
fullDescription

string

คำอธิบายแอปแบบเต็ม (หากมี)

ApplicationPermission

การแสดง JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
ช่อง
permissionId

string

สตริงทึบแสงที่ระบุสิทธิ์แบบไม่ซ้ำ ไม่ได้แปล
name

string

ชื่อของสิทธิ์ แปลแล้ว
description

string

คำอธิบายสิทธิ์ที่ยาวขึ้น โดยให้รายละเอียดเพิ่มเติมเกี่ยวกับสิ่งที่สิทธิ์ส่งผล แปลแล้ว

ManagedProperty

การแสดง JSON 
{
  "key": string,
  "type": enum (ManagedPropertyType),
  "title": string,
  "description": string,
  "entries": [
    {
      object (ManagedPropertyEntry)
    }
  ],
  "defaultValue": value,
  "nestedProperties": [
    {
      object (ManagedProperty)
    }
  ]
}
ช่อง
key

string

คีย์ที่ไม่ซ้ำกันซึ่งแอปใช้เพื่อระบุพร็อพเพอร์ตี้ เช่น "com.google.android.gm.fieldname"
type

enum (ManagedPropertyType)

ประเภทของที่พัก
title

string

ชื่อที่พัก แปลแล้ว
description

string

คำอธิบายที่ยาวขึ้นของพร็อพเพอร์ตี้ โดยให้รายละเอียดเพิ่มเติมเกี่ยวกับสิ่งที่ได้รับผลกระทบ แปลแล้ว
entries[]

object (ManagedPropertyEntry)

สำหรับพร็อพเพอร์ตี้ CHOICE หรือ MULTISELECT รายการของรายการที่เป็นไปได้
defaultValue

value (Value format)

ค่าเริ่มต้นของพร็อพเพอร์ตี้ พร็อพเพอร์ตี้ BUNDLE_ARRAY ไม่มีค่าเริ่มต้น
nestedProperties[]

object (ManagedProperty)

สำหรับพร็อพเพอร์ตี้ BUNDLE_ARRAY รายการพร็อพเพอร์ตี้ที่ซ้อนกัน BUNDLE_ARRAY พร็อพเพอร์ตี้มีระดับได้สูงสุด 2 ระดับ

ManagedPropertyEntry

การแสดง JSON 
{
  "value": string,
  "name": string
}
ช่อง
value

string

ค่าที่เครื่องอ่านได้ของรายการ ซึ่งควรใช้ในการกำหนดค่า ไม่ได้แปล
name

string

ชื่อค่าที่มนุษย์อ่านได้ แปลแล้ว

ค่า

การแสดง 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.
}
ช่อง
ฟิลด์ Union kind ประเภทของค่า kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
nullValue

null

แสดงค่า Null
numberValue

number

แสดงค่าแบบ Double
stringValue

string

แสดงค่าสตริง
boolValue

boolean

แสดงค่าบูลีน
structValue

object (Struct format)

แสดงค่าที่มีโครงสร้าง
listValue

array (ListValue format)

แสดงถึง Value ที่ทำซ้ำ

โครงสร้าง

การแสดง JSON 
{
  "fields": {
    string: value,
    ...
  }
}
ช่อง
fields

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

แมปของค่าที่พิมพ์แบบไดนามิกที่ไม่ได้เรียงลำดับ

ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

การแสดง JSON 
{
  "key": string,
  "value": value
}
ช่อง
key

string
value

value (Value format)

ListValue

การแสดง JSON 
{
  "values": [
    value
  ]
}
ช่อง
values[]

value (Value format)

ฟิลด์ที่ซ้ำของค่าที่พิมพ์แบบไดนามิก

AppTrackInfo

การแสดง JSON 
{
  "trackId": string,
  "trackAlias": string
}
ช่อง
trackId

string

ตัวระบุแทร็กที่ไม่ซ้ำกันซึ่งแก้ไขไม่ได้ โดยนำมาจาก releaseTrackId ใน URL ของหน้า Play Console ที่แสดงข้อมูลแทร็กของแอป
trackAlias

string

ชื่อแทร็กที่เชื่อมโยงกับ trackId ซึ่งตั้งค่าไว้ใน Play Console คุณแก้ไขชื่อได้จาก Play Console

การประทับเวลา

การแสดง JSON 
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง -62135596800 ถึง 253402300799 เท่านั้น (ซึ่งสอดคล้องกับ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z)
nanos

integer

เศษส่วนของวินาทีที่ไม่เป็นค่าลบที่ความละเอียดระดับนาโนวินาที ฟิลด์นี้คือส่วนของระยะเวลาที่เป็นนาโนวินาที ไม่ใช่ทางเลือกแทนวินาที ค่าวินาทีที่เป็นลบซึ่งมีเศษส่วนยังคงต้องมีค่านาโนที่เป็นค่าบวกซึ่งนับไปข้างหน้าตามเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 เท่านั้น

AppVersion

การแสดง JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
ช่อง
versionString

string

สตริงที่นักพัฒนาแอปใช้ใน Play Store เพื่อระบุเวอร์ชัน สตริงไม่จำเป็นต้องไม่ซ้ำกันหรือแปลเป็นภาษาท้องถิ่น (เช่น สตริงอาจเป็น "1.4")
versionCode

integer

ตัวระบุที่ไม่ซ้ำกันที่เพิ่มขึ้นสำหรับเวอร์ชันแอป
trackIds[]

string

ติดตามตัวระบุที่เผยแพร่แอปเวอร์ชันนั้น ซึ่งไม่รวมแทร็กเวอร์ชันที่ใช้งานจริง (ดูเวอร์ชันที่ใช้งานจริงแทน)
production

boolean

หากค่าเป็น "จริง" แสดงว่าเวอร์ชันนี้เป็นแทร็กเวอร์ชันที่ใช้งานจริง

คำอธิบายประกอบเครื่องมือ

คำแนะนำที่ทำลายล้าง: ❌ | คำแนะนำที่ทำซ้ำได้: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบโลกเปิด: ❌