MCP Tools Reference: sheetsmcp.googleapis.com

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

แทรกแถวหรือคอลัมน์ในชีตที่ดัชนีที่ระบุ ซึ่งสอดคล้องกับ InsertDimensionRequest ใน spreadsheets.batchUpdate REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ insert_dimension 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": "insert_dimension",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

InsertDimensionRequest

การแสดง JSON 
{
  "spreadsheetId": string,
  "sheetId": integer,
  "dimension": enum (Dimension),
  "startIndex": integer,
  "endIndex": integer,
  "inheritFromBefore": boolean
}
ช่อง
spreadsheetId

string

ต้องระบุ รหัสของสเปรดชีตที่จะอัปเดต
sheetId

integer

ต้องระบุ รหัสของชีตที่จะแทรก
dimension

enum (Dimension)

ต้องระบุ มิติข้อมูลที่จะแทรก
startIndex

integer

ต้องระบุ ดัชนีเริ่มต้นของการแทรก (รวม) ซึ่งอิงตาม 0
endIndex

integer

ต้องระบุ ดัชนีสิ้นสุดของการแทรก (ไม่รวม) ซึ่งอิงตาม 0
inheritFromBefore

boolean

ระบุว่าจะขยายพร็อพเพอร์ตี้ของมิติข้อมูลจากมิติข้อมูลก่อนหรือหลังมิติข้อมูลที่แทรกใหม่ ระบุเป็น "จริง" เพื่อรับค่าจากมิติข้อมูลก่อนหน้า (ในกรณีนี้ ดัชนีเริ่มต้นต้องมากกว่า 0) และระบุเป็น "เท็จ" เพื่อรับค่าจากมิติข้อมูลหลังจากนั้น

มิติข้อมูล

ระบุมิติข้อมูลที่จะใช้การดำเนินการ

Enum
DIMENSION_UNSPECIFIED ค่าเริ่มต้น ไม่ควรใช้
COLUMNS ดำเนินการกับคอลัมน์ของชีต
ROWS ดำเนินการกับแถวของชีต

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

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

แมปคีย์-ค่าแบบไม่มีลำดับ โดยมีวัตถุประสงค์เพื่อจับความหมายของออบเจ็กต์ JSON ได้อย่างสมบูรณ์ ซึ่งช่วยให้แยกวิเคราะห์เพย์โหลด JSON ที่กำหนดเองเป็นช่องข้อความในรูปแบบ ProtoJSON ได้

เป็นไปตามหลักเกณฑ์ RFC 8259 สำหรับ JSON ที่ทำงานร่วมกันได้ โดยเฉพาะอย่างยิ่ง ประเภทนี้ไม่สามารถแสดงค่า Int64 ขนาดใหญ่หรือตัวเลข NaN/Infinity เนื่องจากรูปแบบ JSON โดยทั่วไปไม่รองรับค่าเหล่านั้นในประเภทตัวเลข

หากคุณไม่ต้องการแยกวิเคราะห์ 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)

ค่า

การแสดง 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

ListValue

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

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

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

คำแนะนำแบบทำลายล้าง: ❌ | คำแนะนำแบบ Idempotent: ❌ | คำแนะนำแบบอ่านอย่างเดียว: ❌ | คำแนะนำแบบ Open World: ✅