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 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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: ✅

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/spreadsheets