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 × 512 بكسل.
smallIconUrl

string

رابط يؤدي إلى صورة أصغر يمكن استخدامها كرمز للتطبيق. هذه الصورة مناسبة للاستخدام بحجم يصل إلى 128 × 128 بكسل.
appTracks[]

object (AppTrackInfo)

قنوات الإصدار التي يمكن للمؤسسة الاطّلاع عليها
author

string

تمثّل هذه السمة اسم مؤلف التطبيقات (على سبيل المثال، مطوّر التطبيق).
playStoreUrl

string

رابط يؤدي إلى صفحة التفاصيل الخاصة بالتطبيق على Google Play (المخصّصة للمستهلكين)
distributionChannel

enum (DistributionChannel)

توضّح هذه السمة كيفية إتاحة الحزمة ولمن.
appPricing

enum (AppPricing)

تُستخدَم لتحديد ما إذا كان التطبيق مجانيًا أو مجانيًا مع إمكانية إجراء عمليات شراء داخل التطبيق أو مدفوعًا. إذا لم يتم تحديد السعر، يعني ذلك أنّ التطبيق لم يعُد متاحًا بشكل عام (على الرغم من أنّه قد يظل متاحًا للمستخدمين الذين يملكونه).
description

string

الوصف الترويجي المترجَم، إذا كان متاحًا
screenshotUrls[]

string

قائمة بروابط لقطات الشاشة التي تمثّل التطبيق
category

string

فئة التطبيق (مثل RACING أو SOCIAL أو غير ذلك)
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 على مستويَين كحدّ أقصى.

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.
}
الحقول
حقل الدمج kind تمثّل هذه السمة نوع القيمة. يمكن أن تكون kind إحدى القيم التالية فقط:
nullValue

null

تمثّل قيمة فارغة.
numberValue

number

تمثّل قيمة مزدوجة.
stringValue

string

تمثّل قيمة سلسلة.
boolValue

boolean

تمثّل قيمة منطقية.
structValue

object (Struct format)

تمثّل قيمة منظَّمة.
listValue

array (ListValue format)

تمثّل هذه السمة Value متكرّرة.

Struct

تمثيل 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)

تمثّل هذه السمة ثواني التوقيت العالمي المنسَّق منذ بدء حقبة 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" من قِبل مطوّر التطبيق لتحديد الإصدار لا يشترط أن تكون السلسلة فريدة أو مترجمة (على سبيل المثال، يمكن أن تكون السلسلة "1.4").
versionCode

integer

معرّف فريد متزايد لإصدار التطبيق.
trackIds[]

string

تتبُّع المعرّفات التي تم نشر إصدار التطبيق فيها ولا يشمل ذلك قناة الإصدار العلني (راجِع الإصدار العلني بدلاً من ذلك).
production

boolean

إذا كانت القيمة True، يشير ذلك إلى أنّ هذا الإصدار هو قناة إصدار علني.

التعليقات التوضيحية للأدوات

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