MCP Tools Reference: sheetsmcp.googleapis.com

Công cụ: update_spreadsheet

Áp dụng một hoặc nhiều nội dung cập nhật cho bảng tính.

Tương ứng với spreadsheets.batchUpdate trong REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

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

  • updateSpreadsheetProperties: Cập nhật các thuộc tính của bảng tính.
  • updateSheetProperties: Cập nhật các thuộc tính của trang tính.
  • updateDimensionProperties: Cập nhật các thuộc tính của phương diện.
  • updateNamedRange: Cập nhật một dải ô được đặt tên.
  • repeatCell: Lặp lại một ô duy nhất trên một dải ô.
  • addNamedRange: Thêm một dải ô được đặt tên.
  • deleteNamedRange: Xoá một dải ô được đặt tên.
  • addSheet: Thêm một trang tính.
  • deleteSheet: Xoá một trang tính.
  • autoFill: Tự động điền thêm dữ liệu dựa trên dữ liệu hiện có.
  • cutPaste: Cắt dữ liệu từ một vùng và dán vào một vùng khác.
  • copyPaste: Sao chép dữ liệu từ một vùng và dán vào một vùng khác.
  • mergeCells: Hợp nhất các ô với nhau.
  • unmergeCells: Huỷ hợp nhất các ô đã hợp nhất.
  • updateBorders: Cập nhật đường viền trong một dải ô.
  • updateCells: Cập nhật nhiều ô cùng một lúc.
  • addFilterView: Thêm một chế độ xem bộ lọc.
  • appendCells: Thêm các ô sau hàng cuối cùng có dữ liệu trong một trang tính.
  • clearBasicFilter: Xoá bộ lọc cơ bản trên một trang tính.
  • deleteDimension: Xoá hàng hoặc cột trong một trang tính.
  • deleteEmbeddedObject: Xoá một đối tượng được nhúng (ví dụ: biểu đồ, hình ảnh) trong một trang tính.
  • deleteFilterView: Xoá một chế độ xem bộ lọc khỏi trang tính.
  • duplicateFilterView: Sao chép một chế độ xem bộ lọc.
  • duplicateSheet: Sao chép một trang tính.
  • findReplace: Tìm và thay thế các trường hợp xuất hiện của một số văn bản bằng văn bản khác.
  • insertDimension: Chèn hàng hoặc cột mới vào trang tính.
  • insertRange: Chèn các ô mới vào một trang tính, di chuyển các ô hiện có.
  • moveDimension: Di chuyển các hàng hoặc cột đến một vị trí khác trong trang tính.
  • updateEmbeddedObjectPosition: Cập nhật vị trí của một đối tượng được nhúng (ví dụ: biểu đồ, hình ảnh).
  • pasteData: Dán dữ liệu (HTML hoặc được phân tách bằng dấu phân cách) vào một trang tính.
  • textToColumns: Chuyển đổi một cột văn bản thành nhiều cột văn bản.
  • updateFilterView: Cập nhật các thuộc tính của một chế độ xem bộ lọc.
  • deleteRange: Xoá một dải ô khỏi trang tính, di chuyển các ô còn lại.
  • appendDimension: Nối các phương diện vào cuối trang tính.
  • addConditionalFormatRule: Thêm một quy tắc định dạng có điều kiện mới.
  • updateConditionalFormatRule: Cập nhật một quy tắc định dạng có điều kiện hiện có.
  • deleteConditionalFormatRule: Xoá một quy tắc định dạng có điều kiện hiện có.
  • sortRange: Sắp xếp dữ liệu trong một dải ô.
  • setDataValidation: Đặt quy trình xác thực dữ liệu cho một hoặc nhiều ô.
  • setBasicFilter: Đặt bộ lọc cơ bản trên một trang tính.
  • addProtectedRange: Thêm một dải ô được bảo vệ.
  • updateProtectedRange: Cập nhật một dải ô được bảo vệ.
  • deleteProtectedRange: Xoá một dải ô được bảo vệ.
  • autoResizeDimensions: Tự động đổi kích thước một hoặc nhiều phương diện dựa trên nội dung của các ô trong phương diện đó.
  • addChart: Thêm biểu đồ.
  • updateChartSpec: Cập nhật các thông số kỹ thuật của biểu đồ.
  • updateBanding: Cập nhật một dải ô có đường viền
  • addBanding: Thêm một dải ô mới
  • deleteBanding: Xoá một dải có đường viền
  • createDeveloperMetadata: Tạo siêu dữ liệu nhà phát triển mới
  • updateDeveloperMetadata: Cập nhật một mục siêu dữ liệu nhà phát triển hiện có
  • deleteDeveloperMetadata: Xoá siêu dữ liệu của nhà phát triển
  • randomizeRange: Trộn ngẫu nhiên thứ tự của các hàng trong một dải ô.
  • addDimensionGroup: Tạo một nhóm trong phạm vi đã chỉ định.
  • deleteDimensionGroup: Xoá một nhóm trong phạm vi đã chỉ định.
  • updateDimensionGroup: Cập nhật trạng thái của nhóm được chỉ định.
  • trimWhitespace: Cắt bỏ khoảng trắng trong các ô (chẳng hạn như dấu cách, dấu tab hoặc dòng mới).
  • deleteDuplicates: Xoá các hàng chứa giá trị trùng lặp trong các cột được chỉ định của một dải ô.
  • updateEmbeddedObjectBorder: Cập nhật đường viền của một đối tượng được nhúng.
  • addSlicer: Thêm bộ cắt.
  • updateSlicerSpec: Cập nhật các thông số kỹ thuật của bộ cắt.
  • addDataSource: Thêm một nguồn dữ liệu.
  • updateDataSource: Cập nhật một nguồn dữ liệu.
  • deleteDataSource: Xoá một nguồn dữ liệu.
  • refreshDataSource: Làm mới một hoặc nhiều nguồn dữ liệu và các đối tượng dbobject được liên kết.
  • cancelDataSourceRefresh: Huỷ làm mới một hoặc nhiều nguồn dữ liệu và dbobject được liên kết.
  • addTable: Thêm bảng.
  • updateTable: Cập nhật một bảng.
  • deleteTable: Yêu cầu xoá một bảng.

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

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

Giản đồ đầu vào

UpdateContentRequest

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

string

Bắt buộc. Mã của bảng tính cần cập nhật.
requests[]

object (Struct format)

Bắt buộc. Danh sách các nội dung cập nhật cần áp dụng cho bảng tính. Mỗi yêu cầu phải là một đối tượng Yêu cầu hợp lệ spreadsheets.batchUpdate, sử dụng giản đồ được ghi lại trong: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request Các yêu cầu sẽ được áp dụng theo thứ tự đượ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 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.

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ẽ khứ hồi thành giá trị 0.

Enum
NULL_VALUE Giá trị rỗng.

Giản đồ đầu ra

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

Một bản đồ khoá-giá trị không theo thứ tự, nhằm mục đích nắm bắt hoàn hảo ngữ nghĩa của một đối tượng JSON. Thao tác này cho phép phân tích cú pháp mọi tải trọng JSON tuỳ ý dưới dạng một trường thông báo ở định dạng ProtoJSON.

Loại này tuân theo các nguyên tắc RFC 8259 về JSON có khả năng tương tác: cụ thể là loại này không thể biểu thị các giá trị Int64 lớn hoặc các số NaN/Infinity, vì định dạng JSON thường không hỗ trợ các giá trị đó trong loại số của nó.

Nếu bạn không có ý định phân tích cú pháp JSON tuỳ ý vào thông báo của mình, thì bạn nên dùng thông báo được nhập tuỳ chỉnh thay vì sử dụng loại này.

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 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.

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ẽ khứ hồ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ở: ✅