MCP Tools Reference: Android Device Management MCP Server

כלי: get_application

מקבל פרטי אפליקציה עבור ארגון ומזהה אפליקציה נתונים. נדרש שם המשאב בפורמט: enterprises/{enterpriseId}/applications/{applicationId}.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ get_application.

בקשת 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

קישור לתמונה שאפשר להשתמש בה כסמל לאפליקציה. התמונה מתאימה לשימוש עד גודל של 512x512 פיקסלים.
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

קטגוריית האפליקציה (למשל, 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

מייצג ערך 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)

מייצג שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ב-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, המשמעות היא שהגרסה הזו היא גרסת ייצור.

הערות על כלי

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌