MCP Tools Reference: sheetsmcp.googleapis.com

Công cụ: insert_dimension

Chèn hàng hoặc cột vào một trang tính tại một chỉ mục cụ thể. Tương ứng với InsertDimensionRequest trong API REST spreadsheets.batchUpdate: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

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

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": "insert_dimension",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

InsertDimensionRequest

Biểu diễn dưới dạng JSON 
{
  "spreadsheetId": string,
  "sheetId": integer,
  "dimension": enum (Dimension),
  "startIndex": integer,
  "endIndex": integer,
  "inheritFromBefore": boolean
}
Trường
spreadsheetId

string

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

integer

Bắt buộc. Mã của trang tính cần chèn vào.
dimension

enum (Dimension)

Bắt buộc. Hàng/cột cần chèn.
startIndex

integer

Bắt buộc. Chỉ mục bắt đầu dựa trên 0 của thao tác chèn (bao gồm).
endIndex

integer

Bắt buộc. Chỉ mục kết thúc dựa trên 0 của thao tác chèn (không bao gồm).
inheritFromBefore

boolean

Có nên mở rộng các thuộc tính của hàng/cột từ các hàng/cột trước hoặc sau các hàng/cột mới chèn hay không. Chọn true để kế thừa từ các hàng/cột trước (trong trường hợp đó, chỉ mục bắt đầu phải lớn hơn 0) và chọn false để kế thừa từ các hàng/cột sau.

Phương diện

Cho biết hàng/cột mà một thao tác sẽ áp dụng.

Enum
DIMENSION_UNSPECIFIED Giá trị mặc định, không sử dụng.
COLUMNS Thao tác trên các cột của một trang tính.
ROWS Thao tác trên các hàng của một trang tính.

Giản đồ đầu ra

Đại diện cho 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. Điều này cho phép phân tích cú pháp bất kỳ tải trọng JSON tuỳ ý nào dưới dạng trường thông báo ở định dạng ProtoJSON.

Điều này tuân theo nguyên tắc RFC 8259 về JSON có khả năng tương tác: đáng chú ý là loại này không thể biểu thị các giá trị Int64 lớn hoặ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 sử dụng thông báo được nhập tuỳ chỉnh thay vì sử dụng loại này.

Cấu trúc

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 theo 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 giá trị sau:
nullValue

null

Đại diện cho JSON null.
numberValue

number

Đại diện cho một số JSON. Không được là NaN, Infinity hoặc -Infinity, vì những giá trị đó không được hỗ trợ trong JSON. Giá trị 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ị đó trong loại số của nó.
stringValue

string

Đại diện cho một chuỗi JSON.
boolValue

boolean

Đại diện cho một giá trị boolean JSON (ký tự true hoặc false trong JSON).
structValue

object (Struct format)

Đại diện cho một đối tượng JSON.
listValue

array (ListValue format)

Đại diện cho 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 JSON null.

NullValue là một giá trị sentinel, sử dụng một enum chỉ có một giá trị để biểu thị giá trị null cho nhóm loại Value.

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

Enum
NULL_VALUE Giá trị null.

Chú thích công cụ

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