MCP Tools Reference: slidesmcp.googleapis.com

ابزار: update_presentation

یک ارائه را با مجموعه‌ای از درخواست‌های batchUpdate به‌روزرسانی می‌کند.

مربوط به presentations.batchUpdate در REST API است.

لیست به‌روزرسانی‌های احتمالی به شرح زیر است:

  • createSlide : یک اسلاید جدید ایجاد می‌کند.
  • createShape : یک شکل جدید ایجاد می‌کند.
  • createTable : یک جدول جدید ایجاد می‌کند.
  • insertText : متن را در یک شکل یا سلول جدول وارد می‌کند.
  • insertTableRows : ردیف‌هایی را در جدول درج می‌کند.
  • insertTableColumns : ستون‌هایی را در جدول درج می‌کند.
  • deleteTableRow : یک سطر از جدول را حذف می‌کند.
  • deleteTableColumn : یک ستون از جدول را حذف می‌کند.
  • replaceAllText : تمام نمونه‌های متن مشخص شده را جایگزین می‌کند.
  • deleteObject : یک صفحه یا عنصر صفحه را از ارائه حذف می‌کند.
  • updatePageElementTransform : تبدیل یک عنصر صفحه را به‌روزرسانی می‌کند.
  • updateSlidesPosition : موقعیت مجموعه‌ای از اسلایدها را در ارائه به‌روزرسانی می‌کند.
  • deleteText : متن را از یک شکل یا یک سلول جدول حذف می‌کند.
  • createImage : یک تصویر ایجاد می‌کند.
  • createVideo : یک ویدیو ایجاد می‌کند.
  • createSheetsChart : یک نمودار Google Sheets جاسازی‌شده ایجاد می‌کند.
  • createLine : یک خط ایجاد می‌کند.
  • refreshSheetsChart : نمودار Google Sheets را به‌روزرسانی می‌کند.
  • updateShapeProperties : ویژگی‌های یک شکل را به‌روزرسانی می‌کند.
  • updateImageProperties : ویژگی‌های یک تصویر را به‌روزرسانی می‌کند.
  • updateVideoProperties : ویژگی‌های یک ویدیو را به‌روزرسانی می‌کند.
  • updatePageProperties : ویژگی‌های یک صفحه را به‌روزرسانی می‌کند.
  • updateTableCellProperties : ویژگی‌های یک TableCell را به‌روزرسانی می‌کند.
  • updateLineProperties : ویژگی‌های یک خط (Line) را به‌روزرسانی می‌کند.
  • createParagraphBullets : برای پاراگراف‌ها، بولت ایجاد می‌کند.
  • replaceAllShapesWithImage : تمام شکل‌هایی که با یک معیار مطابقت دارند را با یک تصویر جایگزین می‌کند.
  • duplicateObject : یک عنصر اسلاید یا صفحه را کپی می‌کند.
  • updateTextStyle : استایل متن درون یک شکل یا جدول را به‌روزرسانی می‌کند.
  • replaceAllShapesWithSheetsChart : تمام شکل‌هایی که با برخی معیارها مطابقت دارند را با نمودار Google Sheets جایگزین می‌کند.
  • deleteParagraphBullets : بولت‌ها را از پاراگراف‌ها حذف می‌کند.
  • updateParagraphStyle : استایل پاراگراف‌های درون یک شکل یا جدول را به‌روزرسانی می‌کند.
  • updateTableBorderProperties : ویژگی‌های حاشیه‌های جدول را در یک جدول به‌روزرسانی می‌کند.
  • updateTableColumnProperties : ویژگی‌های یک ستون جدول را به‌روزرسانی می‌کند.
  • updateTableRowProperties : ویژگی‌های یک سطر جدول را به‌روزرسانی می‌کند.
  • mergeTableCells : سلول‌های یک جدول را ادغام می‌کند.
  • unmergeTableCells : سلول‌های یک جدول را از حالت ادغام خارج می‌کند.
  • groupObjects : اشیاء مانند عناصر صفحه را گروه‌بندی می‌کند.
  • ungroupObjects : اشیاء مانند گروه‌ها را از حالت گروه‌بندی خارج می‌کند.
  • updatePageElementAltText : عنوان متن جایگزین و/یا توضیحات یک عنصر صفحه را به‌روزرسانی می‌کند.
  • replaceImage : یک تصویر موجود را با یک تصویر جدید جایگزین می‌کند.
  • updateSlideProperties : ویژگی‌های یک اسلاید را به‌روزرسانی می‌کند.
  • updatePageElementsZOrder : ترتیب Z عناصر صفحه را به‌روزرسانی می‌کند.
  • importSlides : یک یا چند صفحه اسلاید مشخص شده را از یک ارائه منبع به این ارائه (مقصد) وارد می‌کند.
  • updateLineCategory : دسته‌بندی یک خط را به‌روزرسانی می‌کند.
  • rerouteLine : یک خط را طوری تغییر مسیر می‌دهد که در دو نقطه اتصال نزدیک‌تر روی عناصر صفحه متصل، به هم متصل شود.
  • createAudio : یک صدا در این ارائه ایجاد می‌کند.
  • updateAudioProperties : ویژگی‌های یک صدا را به‌روزرسانی می‌کند.

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

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

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

درخواست به‌روزرسانی یک ارائه.

درخواست ارائه به‌روزرسانی

نمایش JSON 
{
  "presentationId": string,
  "requests": [
    {
      object
    }
  ]
}
فیلدها
presentationId

string

الزامی. شناسه ارائه‌ای که قرار است به‌روزرسانی شود.

requests[]

object ( Struct format)

الزامی. فهرستی از درخواست‌های batchUpdate، با استفاده از طرحواره و معناشناسی مستند شده در https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/request

ساختار

نمایش JSON 
{
  "fields": {
    string: value,
    ...
  }
}
فیلدها
fields

map (key: string, value: value ( Value format))

نقشه نامرتب از مقادیر با نوع پویا.

یک شیء شامل لیستی از جفت‌های "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

فیلدهاورود

نمایش JSON 
{
  "key": string,
  "value": value
}
فیلدها
key

string

value

value ( Value format)

ارزش

نمایش JSON 
{

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

null

نشان دهنده یک JSON null .

numberValue

number

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

stringValue

string

نشان دهنده یک رشته JSON است.

boolValue

boolean

نشان دهنده یک مقدار بولی JSON (در JSON، مقدار حقیقی یا مجازی true یا false ) است.

structValue

object ( Struct format)

نشان دهنده یک شیء JSON است.

listValue

array ( ListValue format)

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

مقدار لیست

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

value ( Value format)

فیلد تکراری با مقادیر تایپ‌شده‌ی پویا.

مقدار تهی

نشان دهنده یک JSON null .

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

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

انوم‌ها
NULL_VALUE مقدار تهی.

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

به‌روزرسانی پاسخ‌های ارائه.

به‌روزرسانیارائهپاسخ

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

object ( Struct format)

مجموعه‌ای از پاسخ‌های batchUpdate، با استفاده از طرحواره و معناشناسی مستند شده در https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/response

ساختار

نمایش JSON 
{
  "fields": {
    string: value,
    ...
  }
}
فیلدها
fields

map (key: string, value: value ( Value format))

نقشه نامرتب از مقادیر با نوع پویا.

یک شیء شامل لیستی از جفت‌های "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

فیلدهاورود

نمایش JSON 
{
  "key": string,
  "value": value
}
فیلدها
key

string

value

value ( Value format)

ارزش

نمایش JSON 
{

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

null

نشان دهنده یک JSON null .

numberValue

number

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

stringValue

string

نشان دهنده یک رشته JSON است.

boolValue

boolean

نشان دهنده یک مقدار بولی JSON (در JSON، مقدار حقیقی یا مجازی true یا false ) است.

structValue

object ( Struct format)

نشان دهنده یک شیء JSON است.

listValue

array ( ListValue format)

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

مقدار لیست

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

value ( Value format)

فیلد تکراری با مقادیر تایپ‌شده‌ی پویا.

مقدار تهی

نشان دهنده یک JSON null .

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

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

انوم‌ها
NULL_VALUE مقدار تهی.

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

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

دامنه‌های مجوز

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

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