MCP Tools Reference: slidesmcp.googleapis.com

ابزار: 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 (رشته، الزامی): شناسه پست پاسخ برای حذف.

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

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

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

UpdatePresentationRequest

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

string

الزامی. شناسه ارائه‌ای که باید به‌روزرسانی شود.
requests[]

object (Struct format)

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

object (WriteControl)

اختیاری. نحوه اجرای درخواست‌های نوشتن را کنترل می‌کند.

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)

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

WriteControl

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

string

شناسه بازبینی ارائه‌ای که برای درخواست نوشتن لازم است. اگر مشخص شده باشد و شناسه ویرایش موردنیاز با شناسه ویرایش کنونی ارائه مطابقت نداشته باشد، درخواست پردازش نمی‌شود و خطای درخواست بد ۴۰۰ برمی‌گرداند.

NullValue

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

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

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

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

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

پاسخ‌های UpdatePresentation.

UpdatePresentationResponse

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

object (Struct format)

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

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
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations