MCP Tools Reference: slidesmcp.googleapis.com

Công cụ: update_presentation

Cập nhật một bản trình bày bằng một nhóm yêu cầu batchUpdate.

Tương ứng với presentations.batchUpdate trong API REST.

Sau đây là danh sách các bản cập nhật có thể có:

  • createSlide: Tạo một trang trình bày mới.
  • createShape: Tạo một hình dạng mới.
  • createTable: Tạo một bảng mới.
  • insertText: Chèn văn bản vào một hình dạng hoặc ô trong bảng.
  • insertTableRows: Chèn các hàng vào một bảng.
  • insertTableColumns: Chèn cột vào bảng.
  • deleteTableRow: Xoá một hàng khỏi bảng.
  • deleteTableColumn: Xoá một cột khỏi bảng.
  • replaceAllText: Thay thế tất cả các trường hợp của văn bản đã chỉ định.
  • deleteObject: Xoá một trang hoặc phần tử trang khỏi bản trình bày.
  • updatePageElementTransform: Cập nhật phép biến đổi của một phần tử trang.
  • updateSlidesPosition: Cập nhật vị trí của một nhóm trang trình bày trong bản trình bày.
  • deleteText: Xoá văn bản khỏi một hình dạng hoặc ô trong bảng.
  • createImage: Tạo hình ảnh.
  • createVideo: Tạo video.
  • createSheetsChart: Tạo biểu đồ được nhúng trong Google Trang tính.
  • createLine: Tạo một đường thẳng.
  • refreshSheetsChart: Làm mới biểu đồ Google Trang tính.
  • updateShapeProperties: Cập nhật các thuộc tính của một Hình dạng.
  • updateImageProperties: Cập nhật các thuộc tính của một Hình ảnh.
  • updateVideoProperties: Cập nhật các thuộc tính của một Video.
  • updatePageProperties: Cập nhật các thuộc tính của một Trang.
  • updateTableCellProperties: Cập nhật các thuộc tính của TableCell.
  • updateLineProperties: Cập nhật các thuộc tính của một Đường kẻ.
  • createParagraphBullets: Tạo dấu đầu dòng cho các đoạn văn.
  • replaceAllShapesWithImage: Thay thế tất cả các hình dạng phù hợp với một số tiêu chí bằng một hình ảnh.
  • duplicateObject: Sao chép một trang trình bày hoặc phần tử trang.
  • updateTextStyle: Cập nhật kiểu văn bản trong Shape (Hình dạng) hoặc Table (Bảng).
  • replaceAllShapesWithSheetsChart: Thay thế tất cả các hình dạng phù hợp với một số tiêu chí bằng một biểu đồ Google Trang tính.
  • deleteParagraphBullets: Xoá dấu đầu dòng khỏi đoạn văn.
  • updateParagraphStyle: Cập nhật kiểu của các đoạn văn trong một Hình dạng hoặc Bảng.
  • updateTableBorderProperties: Cập nhật các thuộc tính của đường viền bảng trong một Bảng.
  • updateTableColumnProperties: Cập nhật các thuộc tính của một cột trong Bảng.
  • updateTableRowProperties: Cập nhật các thuộc tính của một hàng trong Bảng.
  • mergeTableCells: Hợp nhất các ô trong Bảng.
  • unmergeTableCells: Huỷ hợp nhất các ô trong Bảng.
  • groupObjects: Nhóm các đối tượng, chẳng hạn như phần tử trang.
  • ungroupObjects: Huỷ nhóm các đối tượng, chẳng hạn như nhóm.
  • updatePageElementAltText: Cập nhật tiêu đề và/hoặc nội dung mô tả văn bản thay thế của một phần tử trên trang.
  • replaceImage: Thay thế hình ảnh hiện có bằng hình ảnh mới.
  • updateSlideProperties: Cập nhật các thuộc tính của một Trang trình bày.
  • updatePageElementsZOrder: Cập nhật thứ tự Z của các phần tử trang.
  • importSlides: Nhập một hoặc nhiều trang trình bày được chỉ định từ một bản trình bày nguồn vào bản trình bày này (đích).
  • updateLineCategory: Cập nhật danh mục của một dòng.
  • rerouteLine: Định tuyến lại một đường sao cho đường đó được kết nối tại 2 vị trí kết nối gần nhất trên các phần tử trang được kết nối.
  • createAudio: Tạo âm thanh trong bản trình bày này.
  • updateAudioProperties: Cập nhật các thuộc tính của một Audio.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP update_presentation.

Yêu cầu 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
}'

Giản đồ đầu vào

Yêu cầu cập nhật bản trình bày.

UpdatePresentationRequest

Biểu diễn dưới dạng JSON 
{
  "presentationId": string,
  "requests": [
    {
      object
    }
  ]
}
Trường
presentationId

string

Bắt buộc. Mã nhận dạng của bản trình bày cần cập nhật.
requests[]

object (Struct format)

Bắt buộc. Danh sách các yêu cầu batchUpdate, sử dụng giản đồ và ngữ nghĩa được ghi lại tại https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/request

Struct

Biểu diễn dưới dạng JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Trường
fields

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

Bản đồ không có thứ tự của các giá trị được nhập động.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Biểu diễn dưới dạng JSON 
{
  "key": string,
  "value": value
}
Trường
key

string
value

value (Value format)

Giá trị

Biểu diễn dưới dạng JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Trường
Trường nhóm kind. Loại giá trị. kind chỉ có thể là một trong những trạng thái sau:
nullValue

null

Đại diện cho null JSON.
numberValue

number

Biểu thị một số JSON. Không được là NaN, Infinity hoặc -Infinity vì những giá trị này không được hỗ trợ trong JSON. Điều này cũng không thể biểu thị các giá trị Int64 lớn, vì định dạng JSON thường không hỗ trợ các giá trị này trong loại số của nó.
stringValue

string

Biểu thị một chuỗi JSON.
boolValue

boolean

Biểu thị một giá trị boolean JSON (ký tự true hoặc false trong JSON).
structValue

object (Struct format)

Biểu thị một đối tượng JSON.
listValue

array (ListValue format)

Biểu thị một mảng JSON.

ListValue

Biểu diễn dưới dạng JSON 
{
  "values": [
    value
  ]
}
Trường
values[]

value (Value format)

Trường lặp lại của các giá trị được nhập động.

NullValue

Đại diện cho một null JSON.

NullValue là một giá trị lính canh, sử dụng một enum chỉ có một giá trị để biểu thị giá trị rỗng cho hợp nhất loại Value.

Một trường thuộc loại NullValue có bất kỳ giá trị nào khác ngoài 0 đều được coi là không hợp lệ. Hầu hết các trình chuyển đổi tuần tự ProtoJSON sẽ phát ra một Value có null_value được đặt làm null JSON bất kể giá trị số nguyên và do đó sẽ chuyển đổi qua lại thành giá trị 0.

Enum
NULL_VALUE Giá trị rỗng.

Giản đồ đầu ra

Phản hồi UpdatePresentation.

UpdatePresentationResponse

Biểu diễn dưới dạng JSON 
{
  "replies": [
    {
      object
    }
  ]
}
Trường
replies[]

object (Struct format)

Một nhóm phản hồi batchUpdate, sử dụng giản đồ và ngữ nghĩa được ghi lại tại https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/response

Struct

Biểu diễn dưới dạng JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Trường
fields

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

Bản đồ không có thứ tự của các giá trị được nhập động.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Biểu diễn dưới dạng JSON 
{
  "key": string,
  "value": value
}
Trường
key

string
value

value (Value format)

Giá trị

Biểu diễn dưới dạng JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Trường
Trường nhóm kind. Loại giá trị. kind chỉ có thể là một trong những trạng thái sau:
nullValue

null

Đại diện cho null JSON.
numberValue

number

Biểu thị một số JSON. Không được là NaN, Infinity hoặc -Infinity vì những giá trị này không được hỗ trợ trong JSON. Điều này cũng không thể biểu thị các giá trị Int64 lớn, vì định dạng JSON thường không hỗ trợ các giá trị này trong loại số của nó.
stringValue

string

Biểu thị một chuỗi JSON.
boolValue

boolean

Biểu thị một giá trị boolean JSON (ký tự true hoặc false trong JSON).
structValue

object (Struct format)

Biểu thị một đối tượng JSON.
listValue

array (ListValue format)

Biểu thị một mảng JSON.

ListValue

Biểu diễn dưới dạng JSON 
{
  "values": [
    value
  ]
}
Trường
values[]

value (Value format)

Trường lặp lại của các giá trị được nhập động.

NullValue

Đại diện cho một null JSON.

NullValue là một giá trị lính canh, sử dụng một enum chỉ có một giá trị để biểu thị giá trị rỗng cho hợp nhất loại Value.

Một trường thuộc loại NullValue có bất kỳ giá trị nào khác ngoài 0 đều được coi là không hợp lệ. Hầu hết các trình chuyển đổi tuần tự ProtoJSON sẽ phát ra một Value có null_value được đặt làm null JSON bất kể giá trị số nguyên và do đó sẽ chuyển đổi qua lại thành giá trị 0.

Enum
NULL_VALUE Giá trị rỗng.

Chú giải công cụ

Gợi ý mang tính huỷ diệt: ✅ | Gợi ý mang tính luỹ đẳng: ❌ | Gợi ý chỉ đọc: ❌ | Gợi ý về thế giới mở: ✅