MCP Tools Reference: sheetsmcp.googleapis.com

เครื่องมือ: get_values

แสดงผลช่วงของค่าจากสเปรดชีต สอดคล้องกับ spreadsheets.values.get ใน REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ get_values ของ MCP

คำขอ 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
}'

สคีมาอินพุต

GetValuesRequest

การแสดง JSON 
{
  "spreadsheetId": string,
  "range": string
}
ช่อง
spreadsheetId

string

ต้องระบุ รหัสของสเปรดชีตที่จะดึงข้อมูล
range

string

ต้องระบุ สัญกรณ์ A1 หรือสัญกรณ์ R1C1 ของช่วงที่จะดึงค่า

สคีมาเอาต์พุต

ข้อมูลภายในช่วงของสเปรดชีต https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ValueRange

การแสดง JSON 
{
  "range": string,
  "values": [
    array
  ]
}
ช่อง
range

string

ช่วงที่ค่าครอบคลุมใน สัญกรณ์ A1
values[]

array (ListValue format)

ข้อมูลที่อ่าน ซึ่งเป็นอาร์เรย์ของอาร์เรย์ โดยอาร์เรย์ด้านนอกแสดงข้อมูลทั้งหมด และอาร์เรย์ด้านในแต่ละรายการแสดงแถว แต่ละรายการในอาร์เรย์ด้านในจะสอดคล้องกับเซลล์ 1 เซลล์ ระบบจะไม่รวมแถวและคอลัมน์ว่างที่ต่อท้าย

ListValue

การแสดง JSON 
{
  "values": [
    value
  ]
}
ช่อง
values[]

value (Value format)

ฟิลด์ที่ซ้ำได้ของค่าที่พิมพ์แบบไดนามิก

Value

การแสดง JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
ช่อง
ฟิลด์ Union kind ชนิดของค่า kind สามารถเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
nullValue

null

แสดง null ของ JSON
numberValue

number

แสดงตัวเลขของ JSON ต้องไม่ใช่ NaN, Infinity หรือ -Infinity เนื่องจาก JSON ไม่รองรับค่าดังกล่าว นอกจากนี้ยังแสดงค่า Int64 ขนาดใหญ่ไม่ได้ เนื่องจากโดยทั่วไปรูปแบบ JSON ไม่รองรับค่าดังกล่าวในประเภทตัวเลข
stringValue

string

แสดงสตริงของ JSON
boolValue

boolean

แสดงบูลีนของ JSON (true หรือ false ลิเทอรัลใน JSON)
structValue

object (Struct format)

แสดงออบเจ็กต์ของ JSON
listValue

array (ListValue format)

แสดงอาร์เรย์ของ JSON

โครงสร้าง

การแสดง JSON 
{
  "fields": {
    string: value,
    ...
  }
}
ช่อง
fields

map (key: string, value: value (Value format))

แมปแบบไม่มีลำดับของค่าที่พิมพ์แบบไดนามิก

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

การแสดง JSON 
{
  "key": string,
  "value": value
}
ช่อง
key

string
value

value (Value format)

NullValue

แสดง null ของ JSON

NullValue เป็นค่า Sentinel โดยใช้ Enum ที่มีค่าเพียงค่าเดียวเพื่อแสดงค่า Null สำหรับ Union ประเภท Value

ช่องประเภท NullValue ที่มีค่าอื่นที่ไม่ใช่ 0 จะถือว่าไม่ถูกต้อง ซีเรียลไลเซอร์ ProtoJSON ส่วนใหญ่จะแสดง Value ที่ตั้งค่า null_value เป็น null ของ JSON ไม่ว่าค่าจำนวนเต็มจะเป็นเท่าใดก็ตาม และจะส่งกลับค่าเป็น 0

Enum
NULL_VALUE ค่า Null

คำอธิบายประกอบของเครื่องมือ

คำแนะนำที่อาจทำให้เกิดการเปลี่ยนแปลง: ❌ | คำแนะนำที่อาจทำให้เกิดการเปลี่ยนแปลงซ้ำได้: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบเปิด: ✅