MCP Tools Reference: docsmcp.googleapis.com

Công cụ: update_doc

Cập nhật một tài liệu bằng cách sử dụng các yêu cầu cập nhật hàng loạt. Nó chấp nhận yêu cầu documents.batchUpdate (dưới dạng JSON).

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

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

  • replaceAllText: Thay thế tất cả các trường hợp của văn bản đã chỉ định.
  • insertText: Chèn văn bản vào vị trí đã chỉ định.
  • updateTextStyle: Cập nhật kiểu văn bản trong phạm vi đã chỉ định.
  • createParagraphBullets: Tạo dấu đầu dòng cho các đoạn văn.
  • deleteParagraphBullets: Xoá dấu đầu dòng khỏi đoạn văn.
  • createNamedRange: Tạo một dải ô được đặt tên.
  • deleteNamedRange: Xoá một dải ô được đặt tên.
  • updateParagraphStyle: Cập nhật kiểu đoạn văn trong phạm vi đã chỉ định.
  • deleteContentRange: Xoá nội dung khỏi tài liệu.
  • insertInlineImage: Chèn một hình ảnh cùng dòng tại vị trí được chỉ định.
  • insertTable: Chèn một bảng tại vị trí được chỉ định.
  • insertTableRow: Chèn một hàng trống vào bảng.
  • insertTableColumn: Chèn một cột trống vào bảng.
  • deleteTableRow: Xoá một hàng khỏi bảng.
  • deleteTableColumn: Xoá một cột khỏi bảng.
  • insertPageBreak: Chèn dấu ngắt trang tại vị trí đã chỉ định.
  • deletePositionedObject: Xoá một đối tượng được định vị khỏi tài liệu.
  • updateTableColumnProperties: Cập nhật các thuộc tính của cột trong một bảng.
  • updateTableCellStyle: Cập nhật kiểu của các ô trong bảng.
  • updateTableRowStyle: Cập nhật kiểu hàng trong bảng.
  • replaceImage: Thay thế một hình ảnh trong tài liệu.
  • updateDocumentStyle: Cập nhật kiểu của tài liệu.
  • insertInlineSheetsChart: Chèn một biểu đồ Google Trang tính cùng dòng tại vị trí được chỉ định.
  • mergeTableCells: Hợp nhất các ô trong bảng.
  • unmergeTableCells: Huỷ hợp nhất các ô trong bảng.
  • refreshSheetsChart: Làm mới biểu đồ Google Trang tính.
  • createHeader: Tạo tiêu đề.
  • createFooter: Tạo chân trang.
  • createFootnote: Tạo chú thích cuối trang.
  • replaceNamedRangeContent: Thay thế nội dung trong một dải ô được đặt tên.
  • updateEmbeddedObject: Cập nhật các thuộc tính của một đối tượng được nhúng.
  • updateSectionStyle: Cập nhật kiểu phần của phạm vi được chỉ định.
  • insertSectionBreak: Chèn một điểm ngắt đoạn tại vị trí đã chỉ định.
  • deleteHeader: Xoá tiêu đề khỏi tài liệu.
  • deleteFooter: Xoá chân trang khỏi tài liệu.
  • pinTableHeaderRows: Cập nhật số lượng hàng tiêu đề được ghim trong bảng.
  • addDocumentTab: Thêm thẻ tài liệu.
  • deleteTab: Xoá một thẻ tài liệu.
  • updateDocumentTabProperties: Cập nhật các thuộc tính của thẻ tài liệu.
  • insertPerson: Chèn một lượt đề cập đến người dùng.
  • updateNamedStyle: Cập nhật một kiểu có tên.
  • insertRichLink: Chèn một đường liên kết nhiều định dạng.
  • insertDate: Chèn ngày.
  • insertComment: Chèn một CommentThread vào tài liệu.
  • addCommentReply: Thêm câu trả lời vào một CommentThread hoặc SuggestionThread.
  • updateCommentPost: Cập nhật một bài đăng hiện có (bài đăng đầu tiên hoặc câu trả lời) của một CommentThread hoặc SuggestionThread.
  • deleteComment: Xoá một CommentThread.
  • deleteCommentReply: Xoá một bài đăng phản hồi khỏi CommentThread hoặc SuggestionThread.
  • acceptSuggestion: Chấp nhận một đề xuất.
  • rejectSuggestion: Từ chối một đề xuất.
  • deleteSuggestion: Xoá một đề xuất.

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

Yêu cầu Curl 
curl --location 'https://docsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_doc",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

UpdateDocRequest

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

string

Bắt buộc. Mã nhận dạng của tài liệu cần cập nhật. Điều này cũng giống như file_id trong các công cụ của Drive.
requests[]

object (Struct format)

Danh sách các nội dung cập nhật cần áp dụng cho tài liệu. Mỗi yêu cầu phải là một đối tượng Request documents.batchUpdate hợp lệ, sử dụng giản đồ được ghi lại trong: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request Các yêu cầu sẽ được áp dụng theo thứ tự mà chúng được chỉ định. Nếu có yêu cầu không hợp lệ, thì không yêu cầu nào được áp dụng.

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 một 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 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

UpdateDocResponse

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

object (Struct format)

Các câu trả lời từ việc thực thi các yêu cầu cập nhật hàng loạt. Bao gồm các lỗi, cảnh báo và phản hồi thô của API để giúp mô hình điều chỉnh. Các phản hồi thô của API sử dụng giản đồ được ghi lại trong: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/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 một 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 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ở: ✅