MCP Reference: slidesmcp.googleapis.com

ابزارهای «اسلایدنگار Google».

سرور «پروتکل بافتار مدل» (MCP) به‌عنوان یک پراکسی بین سرویس خارجی که بافتار، داده، یا قابلیت‌هایی را برای «مدل زبانی بزرگ» (LLM) یا برنامه هوش مصنوعی فراهم می‌کند عمل می‌کند. سرورهای MCP برنامه‌های هوش مصنوعی را به سیستم‌های خارجی مثل پایگاه‌های داده و سرویس‌های وب متصل می‌کنند و پاسخ‌های آن‌ها را به قالبی که برنامه هوش مصنوعی بتواند بفهمد ترجمه می‌کنند.

ابزارهای «پروتکل زمینه‌ای مدل» (MCP)

ابزار MCP یک تابع یا قابلیت اجرایی است که سرور MCP برای انجام کنش در دنیای واقعی دراختیار برنامه هوش مصنوعی یا مدل زبانی بزرگ قرار می‌دهد.

ابزارها

سرور MCP slidesmcp.googleapis.com ابزارهای زیر را دارد:

ابزارهای «پروتکل زمینه‌ای مدل» (MCP)
read_presentation

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

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

بازخوانی نمایش JSON از یک اسلاید/صفحه از ارائه «اسلایدنگار Google».

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

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

با presentations.pages.getThumbnail در REST API مطابقت دارد.
update_presentation

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

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

فهرست به‌روزرسانی‌های ممکن عبارت است از:

  • ‫createSlide: اسلاید جدیدی ایجاد می‌کند. طرحواره:
    • ‫objectId (رشته، اختیاری): شناسه شیء ارائه‌شده توسط کاربر. اگر مشخص شده باشد باید یکتا باشد (۵ تا ۵۰ نویسه، مطابق با [a-zA-Z0-9_-:]). اگر حذف شود، شناسه‌ای تولید می‌شود.
    • ‫insertionIndex (عدد صحیح، اختیاری): نمایه مبتنی بر صفر که نشان می‌دهد اسلاید در کجا درج شود. اگر حذف شود، در انتها درج می‌شود.
    • ‫slideLayoutReference (شیء، اختیاری): مرجع چیدمان اسلاید برای درج (اگر مشخص شده باشد، دقیقاً یک مورد لازم است):
    • predefinedLayout (رشته): نام چیدمان ازپیش‌تعریف‌شده (برای نمونه، «خالی»، «عنوان و متن»، «عنوان»، «سرصفحه بخش»، «عنوان و شرح بخش»، «نوشتار یک ستونی»، «نکته اصلی»، «عدد بزرگ»، «عنوان و دو ستون»).
    • ‫layoutId (رشته): شناسه چیدمان از نمونه اصلی کنونی.
    • ‫placeholderIdMappings (آرایه اشیا، اختیاری): نگاشت‌های جای‌بان‌ها از چیدمان به اسلاید. هر مورد:
    • ‫layoutPlaceholder (شیء): {"type": string, "index": integer}.
    • objectId (رشته، الزامی): شناسه شیء ارائه‌شده توسط کاربر برای عنصر جای‌بان.
  • ‫createShape: شکل جدیدی ایجاد می‌کند. طرحواره:
    • ‫objectId (رشته، اختیاری): شناسه شیء ارائه‌شده توسط کاربر. اگر حذف شود، شناسه‌ای تولید می‌شود.
    • ‫elementProperties (شیء، الزامی): مکان و اندازه عنصر:
    • pageObjectId (رشته، الزامی): شناسه شیء صفحه‌ای که شکل در آن قرار دارد.
    • size (شیء، اختیاری): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}} (واحد: «PT» یا «EMU»).
    • ‫transform (شیء، اختیاری): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
    • shapeType (رشته، الزامی): نوع شکل (برای نمونه، «RECTANGLE»،‏ «ROUND_RECTANGLE»،‏ «ELLIPSE»،‏ «TEXT_BOX»،‏ «LINE»، و غیره).
  • ‫createTable: جدول جدیدی ایجاد می‌کند. طرحواره:
    • ‫objectId (رشته، اختیاری): شناسه شیء ارائه‌شده توسط کاربر. اگر حذف شود، شناسه‌ای تولید می‌شود.
    • ‫elementProperties (شیء، الزامی): مکان و اندازه عنصر:
    • pageObjectId (رشته، الزامی): شناسه شیء صفحه‌ای که جدول در آن قرار دارد.
    • ‫size (شیء، اختیاری): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • ‫transform (شیء، اختیاری): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
    • ‫rows (عدد صحیح، الزامی): تعداد ردیف‌های جدول.
    • columns (عدد صحیح، الزامی): تعداد ستون‌های جدول.
  • insertText: نوشتار را در شکل یا سلول جدول درج می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء شکل یا جدول.
    • ‫cellLocation (شیء، اختیاری): سلول جدول درصورت درج در جدول: {"rowIndex": integer, "columnIndex": integer}.
    • ‫text (رشته، الزامی): نوشتار برای درج کردن.
    • insertionIndex (عدد صحیح، اختیاری): نمایه نویسه مبتنی بر صفر که نوشتار در آن درج خواهد شد. پیش‌فرض ۰ است.
  • ‫insertTableRows: ردیف‌هایی را در جدول درج می‌کند. طرحواره:
    • tableObjectId (رشته، الزامی): شناسه شیء جدول.
    • ‫cellLocation (شیء، الزامی): مکان سلول مرجع: {"rowIndex": integer, "columnIndex": integer}.
    • insertBelow (بولی، الزامی): اینکه آیا ردیف‌های جدید در زیر سلول مرجع درج شوند یا نه.
    • ‫number (عدد صحیح، الزامی): تعداد ردیف‌هایی که باید درج شود (حداکثر ۲۰).
  • ‫insertTableColumns: ستون‌هایی را در جدول درج می‌کند. طرحواره:
    • tableObjectId (رشته، الزامی): شناسه شیء جدول.
    • ‫cellLocation (شیء، الزامی): مکان سلول مرجع: {"rowIndex": integer, "columnIndex": integer}.
    • insertRight (بولی، الزامی): اینکه آیا ستون‌های جدید در سمت راست سلول مرجع درج شود یا نه.
    • ‫number (عدد صحیح، الزامی): تعداد ستون‌هایی که باید درج شود (حداکثر ۲۰).
  • ‫deleteTableRow: ردیفی را از جدول حذف می‌کند. طرحواره:
    • tableObjectId (رشته، الزامی): شناسه شیء جدول.
    • ‫cellLocation (شیء، الزامی): مکان سلول مرجع: {"rowIndex": integer, "columnIndex": integer}. ردیفی را که حاوی این سلول است حذف می‌کند.
  • deleteTableColumn: ستونی را از جدول حذف می‌کند. طرحواره:
    • tableObjectId (رشته، الزامی): شناسه شیء جدول.
    • ‫cellLocation (شیء، الزامی): مکان سلول مرجع: {"rowIndex": integer, "columnIndex": integer}. ستون حاوی این سلول را حذف می‌کند.
  • ‫replaceAllText: همه نمونه‌های نوشتار مشخص‌شده را جایگزین می‌کند. طرحواره:
    • ‫replaceText (رشته، الزامی): نوشتار جایگزین.
    • ‫containsText (شیء، الزامی): معیارهای مطابقت نوشتار:
    • ‫text (رشته، الزامی): نوشتاری که باید جستجو شود.
    • matchCase (بولی، اختیاری): اینکه جستجو حروف‌حساس باشد یا نه.
    • ‫pageObjectIds (آرایه رشته‌ها، اختیاری): اگر مشخص شود، جایگزینی را به عناصر این صفحه‌ها محدود می‌کند.
  • ‫deleteObject: صفحه یا عنصر صفحه را از ارائه حذف می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء صفحه یا عنصر صفحه‌ای که باید حذف شود.
  • ‫updatePageElementTransform: تبدیل عنصر صفحه را به‌روزرسانی می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء عنصر صفحه برای به‌روزرسانی.
    • ‫transform (شیء، الزامی): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
    • applyMode (رشته، الزامی): حالت اعمال تبدیل: «نسبی» یا «مطلق».
  • updateSlidesPosition: موقعیت مجموعه‌ای از اسلایدها را در ارائه به‌روز می‌کند. طرحواره:
    • ‫slideObjectIds (آرایه رشته‌ها، الزامی): شناسه‌های شیء اسلایدهایی که باید منتقل شوند.
    • ‫insertionIndex (عدد صحیح، الزامی): نمایه صفرپایه که اسلایدها در آن درج خواهند شد.
  • deleteText: نوشتار را از شکل یا سلول جدول حذف می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء شکل یا جدول.
    • ‫cellLocation (شیء، اختیاری): سلول جدول درصورت حذف از جدول: {"rowIndex": integer, "columnIndex": integer}.
    • ‫textRange (شیء، اختیاری): {"startIndex": integer, "endIndex": integer, "type": string}. اگر حذف شود، همه نوشتار حذف می‌شود.
  • createImage: تصویری ایجاد می‌کند. طرحواره:
    • ‫objectId (رشته، اختیاری): شناسه شیء ارائه‌شده توسط کاربر. اگر حذف شود، شناسه‌ای تولید می‌شود.
    • ‫url (رشته، الزامی): نشانی وب تصویری که باید واکشی و ذخیره شود. باید به‌صورت عمومی دردسترس باشد.
    • ‫elementProperties (شیء، الزامی): مکان و اندازه عنصر:
    • pageObjectId (رشته، الزامی): شناسه شیء صفحه‌ای که تصویر در آن قرار خواهد گرفت.
    • ‫size (شیء، اختیاری): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • ‫transform (شیء، اختیاری): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • ‫createVideo: ویدیویی ایجاد می‌کند. طرحواره:
    • ‫objectId (رشته، اختیاری): شناسه شیء ارائه‌شده توسط کاربر. اگر حذف شود، شناسه‌ای تولید می‌شود.
    • source (رشته، الزامی): منبع ویدیو: «YOUTUBE» یا «DRIVE».
    • ‫id (رشته، الزامی): شناسه ویدیو (برای نمونه، شناسه ویدیو YouTube).
    • ‫elementProperties (شیء، الزامی): مکان و اندازه عنصر:
    • ‫pageObjectId (رشته، الزامی): شناسه شیء صفحه‌ای که ویدیو در آن قرار می‌گیرد.
    • ‫size (شیء، اختیاری): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • ‫transform (شیء، اختیاری): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • createSheetsChart: نمودار جاسازی‌شده «کاربرگ‌نگار Google» را ایجاد می‌کند. طرحواره:
    • ‫objectId (رشته، اختیاری): شناسه شیء ارائه‌شده توسط کاربر. اگر حذف شود، شناسه‌ای تولید می‌شود.
    • spreadsheetId (رشته، الزامی): شناسه صفحه‌گسترده «کاربرگ‌نگار Google» حاوی نمودار.
    • chartId (عدد صحیح، الزامی): شناسه نمودار خاص در صفحه‌گسترده.
    • linkingMode (رشته، الزامی): حالت پیوند: «پیوندشده» یا «تصویر پیوندنشده».
    • ‫elementProperties (شیء، الزامی): مکان و اندازه عنصر:
    • pageObjectId (رشته، الزامی): شناسه شیء صفحه‌ای که نمودار در آن قرار می‌گیرد.
    • ‫size (شیء، اختیاری): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • ‫transform (شیء، اختیاری): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • ‫createLine: خطی ایجاد می‌کند. طرحواره:
    • ‫objectId (رشته، اختیاری): شناسه شیء ارائه‌شده توسط کاربر. اگر حذف شود، شناسه‌ای تولید می‌شود.
    • ‫elementProperties (شیء، الزامی): مکان و اندازه عنصر:
    • ‫pageObjectId (رشته، الزامی): شناسه شیء صفحه‌ای که خط در آن قرار می‌گیرد.
    • ‫size (شیء، اختیاری): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • ‫transform (شیء، اختیاری): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
    • ‫category (رشته، الزامی): دسته خط: «STRAIGHT» (مستقیم)، «BENT» (خمیده)، یا «CURVED» (منحنی).
  • ‫refreshSheetsChart: نمودار «کاربرگ‌نگار Google» را بازآوری می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء نموداری که باید بازآوری شود.
  • updateShapeProperties: ویژگی‌های «شکل» را به‌روز می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء شکل برای به‌روزرسانی.
    • ‫shapeProperties (شیء، الزامی): ویژگی‌های شکل برای به‌روزرسانی:
    • ‫shapeBackgroundFill (شیء، اختیاری): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
    • ‫outline (شیء، اختیاری): {"outlineFill": {"solidFill": ...}, "weight": {"magnitude": number, "unit": string}, "dashStyle": string}.
    • ‫shadow (شیء، اختیاری): خصوصیات سایه.
    • ‫link (شیء، اختیاری): مقصد اَبَرپیوند: {"url": string}.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "shapeBackgroundFill" یا "*").
  • ‫updateImageProperties: ویژگی‌های «تصویر» را به‌روز می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء تصویر برای به‌روزرسانی.
    • ‫imageProperties (شیء، الزامی): مشخصه‌های تصویر برای به‌روزرسانی:
    • ‫cropProperties (شیء، اختیاری): جبران‌های برش: {"leftOffset": number, "rightOffset": number, "topOffset": number, "bottomOffset": number, "angle": number}.
    • ‫transparency (عدد، اختیاری): سطح شفافیت (۰٫۰ تا ۱٫۰).
    • brightness (عدد، اختیاری): تنظیم روشنایی (-۱.۰ تا ۱.۰).
    • ‫contrast (عدد، اختیاری): اصلاح کنتراست (-۱٫۰ تا ۱٫۰).
    • ‫recolor (شیء، اختیاری): جلوه تغییر رنگ.
    • ‫shadow (شیء، اختیاری): خصوصیات سایه.
    • ‫outline (شیء، اختیاری): خصوصیات طرح کلی.
    • ‫link (شیء، اختیاری): مقصد اَبَرپیوند: {"url": string}.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "transparency,brightness" یا "*").
  • ‫updateVideoProperties: ویژگی‌های «ویدیو» را به‌روز می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء ویدیویی که باید به‌روز شود.
    • ‫videoProperties (شیء، الزامی): دارایی‌های ویدیو برای به‌روزرسانی:
    • ‫outline (شیء، اختیاری): خصوصیات طرح کلی.
    • autoPlay (بولی، اختیاری): اینکه ویدیو هنگام ارائه به‌طور خودکار پخش شود یا نه.
    • start (عدد صحیح، اختیاری): زمان شروع به ثانیه.
    • end (عدد صحیح، اختیاری): زمان پایان به ثانیه.
    • mute (بولی، اختیاری): اینکه صدا صامت شده است یا نه.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "autoPlay,mute" یا "*").
  • ‫updatePageProperties: ویژگی‌های «صفحه» را به‌روز می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء صفحه‌ای که باید به‌روز شود.
    • ‫pageProperties (شیء، الزامی): خصوصیات صفحه برای به‌روزرسانی:
    • ‫pageBackgroundFill (شیء، اختیاری): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}} یا {"stretchedPictureFill": {"contentUrl": string}}.
    • ‫colorScheme (شیء، اختیاری): آرایش رنگ‌های زمینه.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "pageBackgroundFill" یا "*").
  • ‫updateTableCellProperties: مشخصات TableCell را به‌روز می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء جدول.
    • ‫tableRange (شیء، اختیاری): زیرمجموعه‌ای از سلول‌های جدول برای به‌روزرسانی: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}. اگر حذف شود، روی همه سلول‌ها اعمال می‌شود.
    • ‫tableCellProperties (شیء، الزامی): مشخصات سلول برای به‌روزرسانی:
    • ‫tableCellBackgroundFill (شیء، اختیاری): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
    • ‫contentAlignment (رشته، اختیاری): تراز عمودی: «بالا»، «وسط»، «پایین».
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "tableCellBackgroundFill" یا "*").
  • ‫updateLineProperties: مشخصات «خط» را به‌روز می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء خطی که باید به‌روز شود.
    • ‫lineProperties (شیء، الزامی): مشخصات خط برای به‌روزرسانی:
    • ‫lineFill (شیء، اختیاری): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
    • ‫weight (شیء، اختیاری): ضخامت خط: {"magnitude": number, "unit": string}.
    • dashStyle (رشته، اختیاری): سبک خط تیره: «SOLID»،‏ «DOT»،‏ «DASH»،‏ «DASH_DOT»،‏ «LONG_DASH»،‏ «LONG_DASH_DOT».
    • startArrow (رشته، اختیاری): سبک پیکان شروع: «هیچ‌کدام»، «پیکان مخفی»، «پیکان توپر»، «دایره توپر»، «مربع توپر»، «لوزی توپر»، «پیکان باز»، «دایره باز»، «مربع باز»، «لوزی باز».
    • endArrow (رشته، اختیاری): سبک پیکان پایانی (همان گزینه‌های startArrow).
    • ‫link (شیء، اختیاری): مقصد اَبَرپیوند: {"url": string}.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "lineFill,weight" یا "*").
  • createParagraphBullets: برای پاراگراف‌ها گلوله ایجاد می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء شکل یا جدول.
    • ‫cellLocation (شیء، اختیاری): اگر نوشتار در جدول باشد، سلول جدول: {"rowIndex": integer, "columnIndex": integer}.
    • ‫textRange (شیء، اختیاری): محدوده نوشتار برای گلوله‌ای کردن: {"startIndex": integer, "endIndex": integer, "type": string}.
    • bulletPreset (رشته، اختیاری): پیش‌تنظیم سبک گلوله (برای نمونه، «BULLET_DISC_CIRCLE_SQUARE»،‏ «BULLET_DIAMONDX_ARROW3D_SQUARE»،‏ «NUMBERED_DIGIT_ALPHA_ROMAN»،‏ «NUMBERED_DIGIT_NESTED»). به‌طور پیش‌فرض روی «BULLET_DISC_CIRCLE_SQUARE» تنظیم می‌شود.
  • replaceAllShapesWithImage: همه شکل‌هایی را که با برخی معیارها مطابقت دارند با تصویر جایگزین می‌کند. طرحواره:
    • ‫imageUrl (رشته، الزامی): نشانی وب تصویر برای واکشی و درج.
    • imageReplaceMethod (رشته، اختیاری): روش جایگزینی: «CENTER_INSIDE» (پیش‌فرض) یا «CENTER_CROP».
    • ‫containsText (شیء، الزامی): شکل‌های معیار باید مطابقت داشته باشند:
    • ‫text (رشته، الزامی): نوشتاری که باید در شکل‌ها جستجو شود.
    • matchCase (بولی، اختیاری): اینکه جستجو حروف‌حساس باشد یا نه.
    • ‫pageObjectIds (آرایه رشته‌ها، اختیاری): اگر مشخص شود، جایگزینی را به عناصر این صفحه‌ها محدود می‌کند.
  • duplicateObject: عنصر صفحه یا اسلاید را تکثیر می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء اسلاید یا عنصری که باید تکثیر شود.
    • ‫objectIds (شیء، اختیاری): نگاشت شناسه برای عناصر تکراری: {"originalObjectId": "newObjectId"}. اگر حذف شود، شناسه‌های تصادفی اختصاص داده می‌شود.
  • updateTextStyle: سبک نوشتار را در «شکل» یا «جدول» به‌روز می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء شکل یا جدول.
    • ‫cellLocation (شیء، اختیاری): اگر نوشتار در جدول باشد، سلول جدول: {"rowIndex": integer, "columnIndex": integer}.
    • ‫style (شیء، الزامی): خصوصیات سبک‌پردازی نوشتار:
    • bold (بولی، اختیاری): اینکه نوشتار پررنگ باشد یا نه.
    • italic (بولی، اختیاری): اینکه نوشتار کج باشد یا نه.
    • fontFamily (رشته، اختیاری): خانواده قلم (برای نمونه «Arial»،‏ «Roboto»).
    • ‫fontSize (شیء، اختیاری): اندازه قلم: {"magnitude": number, "unit": string}.
    • ‫foregroundColor (شیء، اختیاری): رنگ قلم: {"opaqueColor": {"rgbColor": {"red": number, "green": number, "blue": number}}}.
    • ‫backgroundColor (شیء، اختیاری): رنگ پس‌زمینه نوشتار: {"opaqueColor": ...}.
    • underline (بولی، اختیاری): اینکه نوشتار زیرخط‌دار باشد یا نه.
    • strikethrough (بولی، اختیاری): اینکه نوشتار خط‌خورده باشد یا نه.
    • smallCaps (بولی، اختیاری): اینکه نوشتار با حروف بزرگ کوچک رندر شود یا نه.
    • ‫baselineOffset (رشته، اختیاری): «هیچ‌کدام»، «بالانویس»، یا «پایین‌نویس».
    • ‫link (شیء، اختیاری): مقصد اَبَرپیوند: {"url": string}.
    • ‫textRange (شیء، اختیاری): محدوده نوشتار برای سبک‌دهی: {"startIndex": integer, "endIndex": integer, "type": string}. اگر حذف شود، روی همه نوشتار اعمال می‌شود.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "bold,foregroundColor" یا "*").
  • ‫replaceAllShapesWithSheetsChart: همه شکل‌هایی را که با معیارهای خاصی مطابقت دارند با نمودار «کاربرگ‌نگار Google» جایگزین می‌کند. طرحواره:
    • spreadsheetId (رشته، الزامی): شناسه صفحه‌گسترده «کاربرگ‌نگار Google» حاوی نمودار.
    • chartId (عدد صحیح، الزامی): شناسه نمودار خاص در صفحه‌گسترده.
    • linkingMode (رشته، الزامی): حالت پیوند: «پیوندشده» یا «تصویر پیوندنشده».
    • ‫containsText (شیء، الزامی): شکل‌های معیار باید مطابقت داشته باشند:
    • ‫text (رشته، الزامی): نوشتاری که باید در شکل‌ها جستجو شود.
    • matchCase (بولی، اختیاری): اینکه جستجو حروف‌حساس باشد یا نه.
    • ‫pageObjectIds (آرایه رشته‌ها، اختیاری): اگر مشخص شود، جایگزینی را به عناصر این صفحه‌ها محدود می‌کند.
  • ‫deleteParagraphBullets: گلوله‌ها را از پاراگراف‌ها حذف می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء شکل یا جدول حاوی نوشتار.
    • ‫cellLocation (شیء، اختیاری): اگر نوشتار در جدول باشد، سلول جدول: {"rowIndex": integer, "columnIndex": integer}.
    • ‫textRange (شیء، اختیاری): محدوده نوشتار برای حذف گلوله‌ها از آن: {"startIndex": integer, "endIndex": integer, "type": string}.
  • updateParagraphStyle: سبک پاراگراف‌های درون «شکل» یا «جدول» را به‌روز می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء شکل یا جدول.
    • ‫cellLocation (شیء، اختیاری): اگر نوشتار در جدول باشد، سلول جدول: {"rowIndex": integer, "columnIndex": integer}.
    • ‫style (شیء، الزامی): خصوصیات سبک پاراگراف:
    • ‫alignment (رشته، اختیاری): تراز کردن نوشتار: «شروع»، «مرکز»، «پایان»، «توجیه».
    • lineSpacing (عدد، اختیاری): درصد فاصله بین خطوط (برای نمونه، ۱۰۰ برای ۱۰۰٪).
    • ‫spaceAbove (شیء، اختیاری): فضای بالای پاراگراف: {"magnitude": number, "unit": string}.
    • ‫spaceBelow (شیء، اختیاری): فضای زیر پاراگراف: {"magnitude": number, "unit": string}.
    • ‫indentFirstLine (شیء، اختیاری): تورفتگی خط اول: {"magnitude": number, "unit": string}.
    • ‫indentStart (شیء، اختیاری): تورفتگی در شروع: {"magnitude": number, "unit": string}.
    • ‫indentEnd (شیء، اختیاری): تورفتگی در انتها: {"magnitude": number, "unit": string}.
    • direction (رشته، اختیاری): جهت نوشتار: «از راست به چپ» یا «از چپ به راست».
    • ‫spacingMode (رشته، اختیاری): حالت فاصله‌گذاری: «NEVER_COLLAPSE» (هرگز جمع نشود) یا «COLLAPSE_LISTS» (فهرست‌ها جمع شود).
    • ‫textRange (شیء، اختیاری): محدوده نوشتار برای سبک‌دهی: {"startIndex": integer, "endIndex": integer, "type": string}. اگر حذف شود، روی همه نوشتار اعمال می‌شود.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "alignment,lineSpacing" یا "*").
  • ‫updateTableBorderProperties: مشخصات حاشیه‌های جدول را در «جدول» به‌روز می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء جدول.
    • ‫tableRange (شیء، اختیاری): زیرمجموعه‌ای از حاشیه‌های جدول برای به‌روزرسانی: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}. اگر حذف شود، برای کل جدول اعمال می‌شود.
    • borderPosition (رشته، الزامی): موقعیت حاشیه: «ALL» (همه)، «BOTTOM» (پایین)، «INNER» (داخلی)، «INNER_HORIZONTAL» (داخلی افقی)، «INNER_VERTICAL» (داخلی عمودی)، «LEFT» (چپ)، «OUTER» (بیرونی)، «RIGHT» (راست)، «TOP» (بالا).
    • ‫tableBorderProperties (شیء، الزامی): خصوصیات حاشیه برای به‌روزرسانی:
    • ‫tableBorderFill (شیء، اختیاری): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
    • ‫weight (شیء، اختیاری): ضخامت حاشیه: {"magnitude": number, "unit": string}.
    • ‫dashStyle (رشته، اختیاری): سبک خط تیره: «SOLID»،‏ «DOT»،‏ «DASH».
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "tableBorderFill,weight" یا "*").
  • updateTableColumnProperties: ویژگی‌های ستون «جدول» را به‌روزرسانی می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء جدول.
    • columnIndices (آرایه اعداد صحیح، الزامی): شاخص‌های صفرمبنای ستون‌هایی که باید به‌روزرسانی شوند.
    • ‫tableColumnProperties (شیء، الزامی): خصوصیات ستون:
    • ‫columnWidth (شیء، اختیاری): عرض ستون: {"magnitude": number, "unit": string}.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "columnWidth" یا "*").
  • updateTableRowProperties: مشخصات ردیف «جدول» را به‌روز می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء جدول.
    • ‫rowIndices (آرایه اعداد صحیح، الزامی): شاخص‌های مبنا صفر ردیف‌هایی که باید به‌روزرسانی شوند.
    • ‫tableRowProperties (شیء، الزامی): خصوصیات ردیف:
    • ‫minRowHeight (شیء، اختیاری): حداقل ارتفاع ردیف: {"magnitude": number, "unit": string}.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "minRowHeight" یا "*").
  • ‫mergeTableCells: سلول‌های «جدول» را ادغام می‌کند. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء جدول.
    • ‫tableRange (شیء، الزامی): محدوده سلول‌ها برای ادغام: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}.
  • ‫unmergeTableCells: سلول‌های «جدول» را از ادغام درمی‌آورد. طرحواره:
    • objectId (رشته، الزامی): شناسه شیء جدول.
    • ‫tableRange (شیء، الزامی): محدوده سلول‌ها برای لغو ادغام: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}.
  • ‫groupObjects: اشیایی مثل عناصر صفحه را گروه‌بندی می‌کند. طرحواره:
    • ‫groupObjectId (رشته، اختیاری): شناسه شیء ارائه‌شده توسط کاربر برای گروه. اگر حذف شود، شناسه‌ای تولید می‌شود.
    • childrenObjectIds (آرایه رشته‌ها، الزامی): شناسه‌های شیء عناصر برای گروه‌بندی (حداقل ۲ مورد الزامی است، در همان صفحه، قبلاً گروه‌بندی نشده باشد).
  • ‫ungroupObjects: اشیایی مثل گروه‌ها را از هم جدا می‌کند. طرحواره:
    • objectIds (آرایه رشته‌ها، الزامی): شناسه‌های شیء گروه‌هایی که باید از هم جدا شوند.
  • updatePageElementAltText: عنوان و/یا شرح متن جایگزین عنصر صفحه را به‌روزرسانی می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء عنصر صفحه.
    • ‫title (رشته، اختیاری): عنوان متن جایگزین به‌روزشده.
    • ‫description (رشته، اختیاری): شرح متن جایگزین به‌روزشده.
  • replaceImage: تصویر موجود را با تصویر جدیدی جایگزین می‌کند. طرحواره:
    • imageObjectId (رشته، الزامی): شناسه شیء تصویر موجود برای جایگزینی.
    • ‫url (رشته، الزامی): نشانی وب تصویر جدید.
    • imageReplaceMethod (رشته، اختیاری): روش جایگزینی: «CENTER_INSIDE» (پیش‌فرض) یا «CENTER_CROP».
  • ‫updateSlideProperties: ویژگی‌های «اسلاید» را به‌روز می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء اسلاید برای به‌روزرسانی.
    • ‫slideProperties (شیء، الزامی): خصوصیات اسلاید:
    • isSkipped (بولی، اختیاری): اینکه آیا اسلاید در حالت ارائه رد شود یا نه.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "isSkipped" یا "*").
  • updatePageElementsZOrder: ترتیب Z عناصر صفحه را به‌روز می‌کند. طرحواره:
    • pageElementObjectIds (آرایه رشته‌ها، الزامی): شناسه‌های شیء عناصر صفحه برای به‌روزرسانی (باید در همان صفحه باشد، گروه‌بندی نشده باشد).
    • operation (رشته، الزامی): عملکرد ترتیب Z: «BRING_TO_FRONT»،‏ «BRING_FORWARD»،‏ «SEND_BACKWARD»،‏ «SEND_TO_BACK».
  • ‫importSlides: یک یا چند صفحه اسلاید مشخص‌شده را از ارائه منبع به این ارائه (مقصد) وارد می‌کند. طرحواره:
    • ‫sourcePresentationId (رشته، الزامی): شناسه ارائه منبع.
    • ‫importIndex (عدد صحیح، اختیاری): نمایه مبتنی بر صفر که اسلایدها در آن وارد می‌شود. اگر حذف شود، در پایان وارد می‌شود.
    • ‫sourceSlides (آرایه اشیا، اختیاری): نگاشت‌های شناسه اسلاید: [{"sourceSlideObjectId": string, "destinationObjectIds": {"sourceObjectId": "destinationObjectId"}}]. اگر حذف شود، همه اسلایدها وارد می‌شود.
    • preserveTheme (رشته، اختیاری): خط‌مشی حفظ زمینه: «USE_SOURCE_THEME» یا «USE_DESTINATION_THEME».
  • ‫updateLineCategory: دسته خط را به‌روز می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء خط اتصال‌دهنده برای به‌روزرسانی.
    • ‫lineCategory (رشته، الزامی): دسته خط: «STRAIGHT» (مستقیم)، «BENT» (خمیده)، یا «CURVED» (منحنی).
  • rerouteLine: خطی را طوری مسیریابی مجدد می‌کند که در دو سایت اتصال نزدیک‌ترین عناصر صفحه متصل به هم متصل شود. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء خط اتصال‌دهنده برای مسیریابی مجدد.
  • ‫createAudio: در این ارائه صدا ایجاد می‌کند. طرحواره:
    • ‫objectId (رشته، اختیاری): شناسه شیء ارائه‌شده توسط کاربر. اگر حذف شود، شناسه‌ای تولید می‌شود.
    • ‫source (رشته، الزامی): منبع صدا: «DRIVE».
    • ‫sourceAudioId (رشته، الزامی): شناسه فایل صوتی در Google Drive.
    • ‫elementProperties (شیء، الزامی): مکان و اندازه عنصر:
    • ‫pageObjectId (رشته، الزامی): شناسه شیء صفحه‌ای که صدا در آن قرار می‌گیرد.
    • ‫size (شیء، اختیاری): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • ‫transform (شیء، اختیاری): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • ‫updateAudioProperties: ویژگی‌های «صوت» را به‌روز می‌کند. طرحواره:
    • ‫objectId (رشته، الزامی): شناسه شیء صوتی برای به‌روزرسانی.
    • ‫audioProperties (شیء، الزامی): خصوصیات صدا:
    • ‫playbackVolume (عدد صحیح، اختیاری): میزان صدای بازپخش از ۰ تا ۱۰۰.
    • repeat (بولی، اختیاری): اینکه آیا بازپخش درحین ارائه به‌طور نامحدود تکرار شود یا نه.
    • showWhenPresenting (بولی، اختیاری): آیا کلیپ صوتی باید درحین ارائه به‌صورت دیداری نشان داده شود.
    • playAcrossSlides (بولی، اختیاری): اینکه آیا صدا در سراسر اسلایدها ادامه می‌یابد یا نه.
    • ‫fields (رشته، الزامی): فهرست فیلدهای جداشده با کاما برای به‌روزرسانی (برای نمونه "playbackVolume,repeat" یا "*").
  • ‫insertComment: نظری را در ارائه درج می‌کند. طرحواره:
    • ‫content (رشته، الزامی): محتوای نظر نوشتار ساده.
    • متن پیوندی (دقیقاً یک مورد الزامی است):
    • ‫shapeTextAnchor (شیء): برای چسباندن به نوشتار داخل شکل:
      • shapeId (رشته، الزامی): شناسه شیء شکل.
      • ‫textRange (شیء، اختیاری): {"startIndex": int, "endIndex": int}.
    • ‫objectId (رشته): برای لنگر انداختن در صفحه یا عنصر.
  • addCommentReply: پاسخی به نظر موجود اضافه می‌کند. طرحواره:
    • ‫commentId (رشته، الزامی): شناسه رشته نظر.
    • ‫post (شیء، الزامی): {"content": "reply text"}.
  • updateCommentPost: محتوای پست نظر در رشته نظر را به‌روز می‌کند. طرحواره:
    • ‫commentId (رشته، الزامی): شناسه رشته نظر.
    • ‫postId (رشته، الزامی): شناسه پست نظر برای به‌روزرسانی.
    • ‫content (رشته، الزامی): محتوای به‌روزشده پست نظر.
  • ‫deleteComment: رشتهٔ نظرات را حذف می‌کند. طرحواره:
    • ‫commentId (رشته، الزامی): شناسه رشته نظر برای حذف.
  • ‫deleteCommentReply: پست پاسخ را حذف می‌کند. طرحواره:
    • ‫commentId (رشته، الزامی): شناسه رشته نظر.
    • ‫postId (رشته، الزامی): شناسه پست پاسخ برای حذف.

دریافت مشخصات ابزار MCP

برای دریافت مشخصات ابزار MCP برای همه ابزارهای موجود در سرور MCP، از روش tools/list استفاده کنید. مثال زیر نشان می‌دهد که چگونه از curl برای فهرست کردن همه ابزارها و مشخصات آن‌ها که درحال‌حاضر در سرور MCP دردسترس است استفاده کنید.

درخواست Curl 
curl --location 'https://slidesmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'