MCP Tools Reference: sheetsmcp.googleapis.com

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

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

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

สคีมาอินพุต

UpdateValuesRequest

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

string

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

string

ต้องระบุ รูปแบบ A1 ของค่าที่จะอัปเดต
values[]

array (ListValue format)

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

ListValue

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

value (Value format)

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

ค่า

การแสดง JSON 
{

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

null

แสดง JSON null
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

แสดง JSON null

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

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

Enum
NULL_VALUE ค่า Null

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

แสดงออบเจ็กต์ 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

แสดง JSON null
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

แสดง JSON null

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

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

Enum
NULL_VALUE ค่า Null

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

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

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

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

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