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"
  • ‫createLine: لإنشاء خط
  • refreshSheetsChart: يعيد تحميل رسم بياني في "جداول بيانات Google".
  • updateShapeProperties: تعدّل هذه السمة خصائص الشكل.
  • ‫updateImageProperties: تعدّل هذه الطريقة خصائص صورة.
  • updateVideoProperties: تعدّل هذه الطريقة خصائص فيديو.
  • ‫updatePageProperties: تعدّل هذه الطريقة خصائص الصفحة.
  • updateTableCellProperties: تعدّل هذه السمة خصائص TableCell.
  • updateLineProperties: تعدّل خصائص خط.
  • ‫createParagraphBullets: لإنشاء نقاط تعداد للفقرات
  • replaceAllShapesWithImage: يستبدل هذا الإجراء كل الأشكال التي تتطابق مع بعض المعايير بصورة.
  • duplicateObject: لتكرار شريحة أو عنصر صفحة
  • updateTextStyle: تعدّل هذه السمة نمط النص داخل شكل أو جدول.
  • replaceAllShapesWithSheetsChart: يستبدل جميع الأشكال التي تتطابق مع بعض المعايير برسم بياني من "جداول بيانات Google".
  • deleteParagraphBullets: لحذف النقاط من الفقرات
  • updateParagraphStyle: تعدّل هذه السمة نمط الفقرات داخل "شكل" أو "جدول".
  • استبدِل updateTableBorderProperties: لتعديل خصائص حدود الجدول في جدول.
  • ‫updateTableColumnProperties: تعدّل خصائص عمود جدول.
  • ‫updateTableRowProperties: تعدّل هذه الطريقة خصائص صف في جدول.
  • ‫mergeTableCells: لدمج الخلايا في جدول
  • ‫unmergeTableCells: لإلغاء دمج الخلايا في جدول
  • ‫groupObjects: تجميع العناصر، مثل عناصر الصفحة
  • ungroupObjects: لإلغاء تجميع العناصر، مثل المجموعات
  • updatePageElementAltText: تعدّل عنوان النص البديل و/أو وصف عنصر الصفحة.
  • replaceImage: استبدال صورة حالية بصورة جديدة
  • ‫updateSlideProperties: تعدّل هذه الطريقة خصائص شريحة.
  • updatePageElementsZOrder: تعدّل ترتيب Z لعناصر الصفحة.
  • importSlides: تستورد هذه السمة صفحة واحدة أو أكثر من صفحات الشرائح المحدّدة من عرض تقديمي مصدر إلى هذا العرض التقديمي (الوجهة).
  • ‫updateLineCategory: تعدّل فئة سطر.
  • rerouteLine: يعيد توجيه خط بحيث يتم ربطه بموقعَي الربط الأقرب على عناصر الصفحة المرتبطة.
  • createAudio: لإنشاء صوت في هذا العرض التقديمي
  • ‫updateAudioProperties: تعدّل هذه السمة خصائص ملف صوتي.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة update_presentation MCP.

طلب Curl 
curl --location 'https://slidesmcp.googleapis.com/mcp' \
--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
}'

مخطط الإدخال

طلب تعديل عرض تقديمي

UpdatePresentationRequest

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

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 قيمة فارغة

مخطط النتائج

استجابات UpdatePresentation

UpdatePresentationResponse

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

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 قيمة فارغة

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

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