MCP Tools Reference: sheetsmcp.googleapis.com

Công cụ: update_values

Đặt các giá trị trong một dải ô của bảng tính. Tương ứng với spreadsheets.values.update trong REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update

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

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

Giản đồ đầu vào

UpdateValuesRequest

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

string

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

string

Bắt buộc. Ký hiệu A1 của các giá trị cần cập nhật.
values[]

array (ListValue format)

Bắt buộc. Dữ liệu đã được đọc hoặc sẽ được ghi. Đây là một mảng gồm các mảng, trong đó mảng bên ngoài đại diện cho tất cả dữ liệu và mỗi mảng bên trong đại diện cho một hàng. Mỗi mục trong mảng bên trong tương ứng với một ô. Các loại giá trị được hỗ trợ là: bool, string và double. Các giá trị rỗng sẽ bị bỏ qua. Để đặt một ô thành giá trị trống, hãy đặt giá trị chuỗi thành một chuỗi trống.

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.

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.

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)

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ở: ✅