MCP Tools Reference: sheetsmcp.googleapis.com

Công cụ: get_values

Trả về một dải giá trị từ bảng tính. Tương ứng với spreadsheets.values.get trong REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ get_values 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": "get_values",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

GetValuesRequest

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

string

Bắt buộc. Mã của bảng tính để truy xuất dữ liệu.
range

string

Bắt buộc. Ký hiệu A1 hoặc ký hiệu R1C1 của dải ô để truy xuất giá trị.

Giản đồ đầu ra

Dữ liệu trong một dải ô của bảng tính. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ValueRange

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

string

Dải ô chứa các giá trị, ở ký hiệu A1.
values[]

array (ListValue format)

Dữ liệu đã đọc. Đây là một mảng các mảng, 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 hàng và cột trống ở cuối sẽ không được đưa vào.

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.

Value

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 loại sau:
nullValue

null

Đại diện cho JSON null.
numberValue

number

Đại diện cho 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ể đại diện cho 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ố.
stringValue

string

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

boolean

Đại diện cho giá trị boolean JSON (literal true hoặc false trong JSON).
structValue

object (Struct format)

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

array (ListValue format)

Đại diện cho 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 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)

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ị để đại diện cho giá trị null cho nhóm loại Value.

Một trường thuộc loại NullValue có giá trị khác 0 đượ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 thành giá trị 0.

Enum
NULL_VALUE Giá trị null.

Chú thích công cụ

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