MCP Tools Reference: Android Device Management MCP Server

ابزار: list_web_apps

برنامه‌های وب مربوط به یک شرکت مشخص را فهرست می‌کند. به نام منبع شرکت در فیلد والد نیاز دارد (مثلاً enterprises/{enterpriseId}).

مثال زیر نحوه استفاده از curl برای فراخوانی ابزار list_web_apps 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": "list_web_apps",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

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

درخواست ListWebApps

نمایش JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
فیلدها
parent

string

نام شرکت به شکل enterprises/{enterpriseId} .

pageSize

integer

اندازه صفحه درخواستی. این یک راهنما است و اندازه واقعی صفحه در پاسخ ممکن است متفاوت باشد.

pageToken

string

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

طرحواره خروجی

پاسخ به درخواست فهرست کردن برنامه‌های وب برای یک شرکت مشخص.

پاسخ ListWebApps

نمایش JSON 
{
  "webApps": [
    {
      object (WebApp)
    }
  ],
  "nextPageToken": string
}
فیلدها
webApps[]

object ( WebApp )

فهرست برنامه‌های وب.

nextPageToken

string

اگر نتایج بیشتری وجود داشته باشد، یک توکن برای بازیابی صفحه بعدی نتایج.

وب‌اپلیکیشن

نمایش JSON 
{
  "name": string,
  "title": string,
  "startUrl": string,
  "icons": [
    {
      object (WebAppIcon)
    }
  ],
  "displayMode": enum (DisplayMode),
  "versionCode": string
}
فیلدها
name

string

نام برنامه وب، که توسط سرور در حین ایجاد در قالب enterprises/{enterpriseId}/webApps/{packageName} تولید می‌شود.

title

string

عنوان برنامه وب که به کاربر نمایش داده می‌شود (مثلاً در میان لیستی از برنامه‌های دیگر، یا به عنوان برچسبی برای یک آیکون).

startUrl

string

آدرس شروع، یعنی آدرسی که باید هنگام باز شدن برنامه توسط کاربر بارگذاری شود.

icons[]

object ( WebAppIcon )

فهرستی از آیکون‌ها برای برنامه وب. باید حداقل یک عنصر داشته باشد.

displayMode

enum ( DisplayMode )

حالت نمایش برنامه وب.

versionCode

string ( int64 format)

نسخه فعلی برنامه.

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

آیکون وب‌اپلیکیشن

نمایش JSON 
{
  "imageData": string
}
فیلدها
imageData

string

بایت‌های واقعی تصویر در یک رشته کدگذاری شده با base64url (به RFC4648، بخش 5 "کدگذاری پایه 64 با الفبای امن URL و نام فایل" مراجعه کنید).

  • نوع تصویر می‌تواند png یا jpg باشد.
  • تصویر در حالت ایده‌آل باید مربع باشد.
  • تصویر در حالت ایده‌آل باید اندازه ۵۱۲x۵۱۲ داشته باشد.

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

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