MCP Tools Reference: Android Device Management MCP Server

ابزار: get_application

جزئیات برنامه و شناسه برنامه را برای یک شرکت مشخص دریافت می‌کند. نام منبع را با فرمت زیر نیاز دارد: enterprises/{enterpriseId}/applications/{applicationId}.

مثال زیر نحوه استفاده از curl برای فراخوانی ابزار get_application MCP را نشان می‌دهد.

درخواست کرل 
                  
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
}'

طرحواره ورودی

درخواست برای دریافت اطلاعات در مورد یک برنامه.

درخواست برنامه را دریافت کنید

نمایش 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

پیوندی به تصویری که می‌تواند به عنوان نماد برنامه استفاده شود. این تصویر برای استفاده تا اندازه پیکسل ۵۱۲ در ۵۱۲ مناسب است.

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

حداقل SDK اندروید مورد نیاز برای اجرای برنامه.

contentRating

enum ( ContentRating )

رتبه‌بندی محتوای این برنامه.

updateTime

string ( Timestamp format)

فقط خروجی. زمان تقریبی (ظرف ۷ روز) آخرین انتشار برنامه.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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

توضیحات کامل برنامه، در صورت وجود.

مجوز برنامه

نمایش JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
فیلدها
permissionId

string

یک رشته‌ی کدر که به طور منحصر به فرد مجوز را مشخص می‌کند. بومی‌سازی نشده است.

name

string

نام مجوز. محلی‌سازی شده.

description

string

شرح مفصل‌تری از مجوز، که جزئیات بیشتری در مورد آنچه که تحت تأثیر قرار می‌دهد، ارائه می‌دهد. بومی‌سازی شده.

املاک مدیریت‌شده

نمایش 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 حداکثر دو سطح عمق دارد.

ورود املاک مدیریت‌شده

نمایش 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

نشان دهنده یک مقدار مضاعف است.

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" } .

فیلدهاورود

نمایش JSON 
{
  "key": string,
  "value": value
}
فیلدها
key

string

value

value ( Value format)

مقدار لیست

نمایش JSON 
{
  "values": [
    value
  ]
}
فیلدها
values[]

value ( Value format)

فیلد تکراری با مقادیر تایپ‌شده‌ی پویا.

اطلاعات ردیابی برنامه

نمایش JSON 
{
  "trackId": string,
  "trackAlias": string
}
فیلدها
trackId

string

شناسه منحصر به فرد آهنگ که قابل تغییر نیست، از releaseTrackId در URL صفحه Play Console که اطلاعات آهنگ برنامه را نمایش می‌دهد، گرفته شده است.

trackAlias

string

نام آهنگ مرتبط با trackId که در کنسول Play تنظیم شده است. این نام از کنسول Play قابل تغییر است.

مهر زمانی

نمایش JSON 
{
  "seconds": string,
  "nanos": integer
}
فیلدها
seconds

string ( int64 format)

ثانیه‌های زمان UTC را از زمان یونیکس ۱۹۷۰-۰۱-۰۱T۰۰:۰۰:۰۰Z نشان می‌دهد. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).

nanos

integer

کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه از مدت زمان است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان دارای مقادیر نانوثانیه غیرمنفی باشند که در زمان به جلو شمارش می‌شوند. باید بین ۰ تا ۹۹۹۹۹۹۹۹۹۹ باشد.

نسخه برنامه

نمایش JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
فیلدها
versionString

string

رشته‌ای که در فروشگاه پلی توسط توسعه‌دهنده‌ی برنامه برای شناسایی نسخه استفاده می‌شود. این رشته لزوماً منحصر به فرد یا بومی‌سازی شده نیست (برای مثال، رشته می‌تواند "1.4" باشد).

versionCode

integer

شناسه افزایشی منحصر به فرد برای نسخه برنامه.

trackIds[]

string

شناسه‌های مسیر که نسخه برنامه در آن منتشر شده است. این شامل مسیر تولید نمی‌شود (به جای آن به تولید مراجعه کنید).

production

boolean

اگر مقدار آن True باشد، نشان می‌دهد که این نسخه، یک مسیر تولید انبوه است.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌