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: นำเข้าหน้าสไลด์ที่ระบุอย่างน้อย 1 หน้าจากงานนำเสนอต้นทางไปยังงานนำเสนอนี้ (ปลายทาง)
  • updateLineCategory: อัปเดตหมวดหมู่ของบรรทัด
  • rerouteLine: เปลี่ยนเส้นทางเพื่อให้เชื่อมต่อที่จุดเชื่อมต่อที่ใกล้ที่สุด 2 จุดในองค์ประกอบหน้าเว็บที่เชื่อมต่อ
  • 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
}
ช่อง
ฟิลด์ Union kind ประเภทของค่า kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
nullValue

null

แสดง JSON null
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

แสดง JSON null

NullValue เป็นตัวคั่น โดยใช้ enum ที่มีค่าเพียงค่าเดียวเพื่อแสดงค่า Null สำหรับการรวมประเภท Value

ฟิลด์ประเภท NullValue ที่มีค่าอื่นที่ไม่ใช่ 0 จะถือว่าไม่ถูกต้อง โปรแกรมซีเรียลไลซ์ ProtoJSON ส่วนใหญ่จะส่ง Value ที่มี null_value ตั้งค่าเป็น JSON null โดยไม่คำนึงถึงค่าจำนวนเต็ม และจะส่งกลับค่า 0

Enum
NULL_VALUE ค่า Null

สคีมาเอาต์พุต

การตอบกลับ 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
}
ช่อง
ฟิลด์ Union kind ประเภทของค่า kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
nullValue

null

แสดง JSON null
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

แสดง JSON null

NullValue เป็นตัวคั่น โดยใช้ enum ที่มีค่าเพียงค่าเดียวเพื่อแสดงค่า Null สำหรับการรวมประเภท Value

ฟิลด์ประเภท NullValue ที่มีค่าอื่นที่ไม่ใช่ 0 จะถือว่าไม่ถูกต้อง โปรแกรมซีเรียลไลซ์ ProtoJSON ส่วนใหญ่จะส่ง Value ที่มี null_value ตั้งค่าเป็น JSON null โดยไม่คำนึงถึงค่าจำนวนเต็ม และจะส่งกลับค่า 0

Enum
NULL_VALUE ค่า Null

คำอธิบายประกอบเครื่องมือ

คำแนะนำที่ทำลายล้าง: ✅ | คำแนะนำที่ทำซ้ำได้: ❌ | คำแนะนำแบบอ่านอย่างเดียว: ❌ | คำแนะนำแบบโลกเปิด: ✅