MCP Tools Reference: slidesmcp.googleapis.com

ابزار: read_presentation

نمایش JSON ارائه «اسلایدنگار Google» را بخوانید.

با presentations.get در REST API مطابقت دارد.

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

درخواست Curl 
curl --location 'https://slidesmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "read_presentation",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

درخواست خواندن ارائه.

ReadPresentationRequest

نمایش JSON 
{
  "presentationId": string,
  "fields": [
    string
  ],

  "commentsIncluded": boolean
}
فیلدها
presentationId

string

الزامی. شناسه ارائه‌ای که محتوا از آن خوانده می‌شود.
fields[]

string

اختیاری. پوشش فیلدی که مشخص می‌کند کدام زیرمجموعه از دارایی‌ها برگردانده شود. مسیرها باید دقیقاً با ساختار منبع JSON «میانای برنامه‌سازی کاربردی REST اسلایدنگار Google» مطابقت داشته باشند (برای نمونه، «ارائه»، «صفحه»، «عنصر صفحه»، «شکل»، «تصویر»، «جدول»، «خط»، «ویدیو»، «محتوای نوشتاری»).

دستورالعمل‌های مهم: - همیشه از پوشش‌های فیلد هدف‌گذاری‌شده به‌جای واکشی کردن اشیای ارائه کامل عمومی یا بدون پوشش استفاده کنید. - دستورگان: از نماد نقطه‌ای و پرانتزهای زیرانتخاب پشتیبانی می‌کند (برای نمونه، slides.pageElements(objectId,shape.text) یا slides.pageElements.objectId,slides.pageElements.shape.text). - فقط فیلدهایی را که نیاز دارید اضافه کنید.

فیلد اتحادیه _comments_included.

‫_comments_included فقط می‌تواند یکی از موارد زیر باشد:
commentsIncluded

boolean

اختیاری. اگر درست باشد، نظرات در پاسخ گنجانده خواهد شد. به‌طور پیش‌فرض، نظرات اضافه نمی‌شوند.

طرح‌واره برونداد

پاسخ حاوی نمایش JSON ارائه.

ReadPresentationResponse

نمایش JSON 
{
  "content": {
    object
  }
}
فیلدها
content

object (Struct format)

نمایش JSON از ارائه «اسلایدنگار Google».

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)

مقدار

نمایش JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
فیلدها
فیلد اتحادیه kind. نوع مقدار. ‫kind فقط می‌تواند یکی از موارد زیر باشد:
nullValue

null

نشان‌دهنده null در JSON است.
numberValue

number

نشان‌دهنده عدد JSON است. نباید NaN، Infinity، یا -Infinity باشد، زیرا در JSON پشتیبانی نمی‌شوند. این همچنین نمی‌تواند مقادیر بزرگ Int64 را نشان دهد، زیرا قالب JSON به‌طورکلی از آن‌ها در نوع عدد خود پشتیبانی نمی‌کند.
stringValue

string

نشان‌دهنده رشته JSON است.
boolValue

boolean

نشان‌دهنده مقدار بولی JSON (حرفی true یا false در JSON).
structValue

object (Struct format)

نشان‌دهنده شیء JSON است.
listValue

array (ListValue format)

نشان‌دهنده آرایه JSON است.

ListValue

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

value (Value format)

فیلد تکراری مقادیر با نوع پویا.

NullValue

نشان‌دهنده null در JSON است.

‫NullValue نگهبان است و از شمارشی با فقط یک مقدار برای نشان دادن مقدار تهی برای اجتماع نوع Value استفاده می‌کند.

فیلدی از نوع NullValue با هر مقداری به‌جز 0 نامعتبر درنظر گرفته می‌شود. اکثر سریال‌سازهای ProtoJSON‏ Value را با null_value تنظیم‌شده به‌عنوان null در JSON صرف‌نظر از مقدار عدد صحیح منتشر می‌کنند و بنابراین به مقدار 0 تبدیل می‌شوند.

شمارشی‌ها
NULL_VALUE مقدار تهی.

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

گزارمان‌های ابزار برای توصیف خطر اولیه یک ابزار معین به کارخواهان MCP ارسال می‌شود. اکثر کارخواه‌ها این نشانه‌ها را به‌عنوان نامطمئن درنظر می‌گیرند، اما می‌توان از آن‌ها برای تصمیم‌گیری درباره زمان ارسال پیام‌واره تأیید به کاربر استفاده کرد.

به‌همراه رشته عنوان، نشان‌های بولی زیر به این صورت تعریف می‌شوند:

  • ‫readOnlyHint: اگر درست باشد، ابزار محیطش را تغییر نمی‌دهد. پیش‌فرض: نادرست.
  • ‫destructiveHint: اگر درست باشد، ابزار می‌تواند کنش‌های مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند کنش‌های افزودنی انجام دهد. پیش‌فرض: درست.
  • idempotentHint: اگر درست باشد، فراخوانی مکرر ابزار با همان آرگومان‌ها تأثیر اضافه‌ای بر محیط آن نخواهد داشت. پیش‌فرض: نادرست.
  • ‫openWorldHint: اگر درست باشد، ابزار می‌تواند با «دنیای باز» نهادهای خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با نهادهای داخلی تعامل داشته باشد. برای مثال، ابزار جستجوی وب دنیای باز است، اما ابزار حافظه دنیای باز نیست.

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

دوربین تفنگ مجوز

به یکی از محدوده‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/presentations.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations