MCP Tools Reference: Android Device Management MCP Server

الأداة: list_web_apps

تعرض هذه الطريقة تطبيقات الويب لمؤسسة معيّنة. يتطلّب اسم مورد المؤسسة في الحقل الرئيسي (مثل enterprises/{enterpriseId}).

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة list_web_apps 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": "list_web_apps",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

طلب إدراج تطبيقات الويب لمؤسسة معيّنة

ListWebAppsRequest

تمثيل JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
الحقول
parent

string

اسم المؤسسة بالتنسيق enterprises/{enterpriseId}
pageSize

integer

حجم الصفحة المطلوب. هذه إشارة وقد يختلف حجم الصفحة الفعلي في الردّ.
pageToken

string

رمز مميز يعرّف صفحة من النتائج التي يعرضها الخادم.

مخطط النتائج

ردّ على طلب إدراج تطبيقات الويب لمؤسسة معيّنة

ListWebAppsResponse

تمثيل JSON 
{
  "webApps": [
    {
      object (WebApp)
    }
  ],
  "nextPageToken": string
}
الحقول
webApps[]

object (WebApp)

قائمة تطبيقات الويب
nextPageToken

string

إذا كانت هناك نتائج إضافية، سيتم عرض رمز مميز لاسترداد الصفحة التالية من النتائج.

WebApp

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

عنوان URL لبدء التشغيل، أي عنوان URL الذي يجب تحميله عندما يفتح المستخدم التطبيق
icons[]

object (WebAppIcon)

قائمة برموز تطبيق الويب، ويجب أن تحتوي على عنصر واحد على الأقل.
displayMode

enum (DisplayMode)

وضع عرض تطبيق الويب
versionCode

string (int64 format)

الإصدار الحالي من التطبيق

يُرجى العِلم أنّه يمكن زيادة رقم الإصدار تلقائيًا خلال فترة استخدام تطبيق الويب، بينما تجري Google عمليات صيانة داخلية للحفاظ على تحديث تطبيق الويب.

WebAppIcon

تمثيل JSON 
{
  "imageData": string
}
الحقول
imageData

string

تمثّل هذه السمة وحدات البايت الفعلية للصورة في سلسلة base64url مرمّزة (يُرجى الرجوع إلى RFC4648، القسم 5 "ترميز Base 64 باستخدام الأبجدية الآمنة لعنوان URL واسم الملف").

  • يمكن أن يكون نوع الصورة png أو jpg.
  • يُفضَّل أن تكون الصورة مربّعة.
  • يجب أن يكون حجم الصورة 512x512 بكسل.

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

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