MCP Tools Reference: sheetsmcp.googleapis.com

Alat: insert_dimension

Menyisipkan baris atau kolom dalam sheet pada indeks tertentu. Sesuai dengan InsertDimensionRequest di spreadsheets.batchUpdate REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP insert_dimension.

Permintaan 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
}'

Skema Input

InsertDimensionRequest

Representasi JSON 
{
  "spreadsheetId": string,
  "sheetId": integer,
  "dimension": enum (Dimension),
  "startIndex": integer,
  "endIndex": integer,
  "inheritFromBefore": boolean
}
Kolom
spreadsheetId

string

Wajib. ID spreadsheet yang akan diperbarui.
sheetId

integer

Wajib. ID sheet yang akan disisipkan.
dimension

enum (Dimension)

Wajib. Dimensi yang akan disisipkan.
startIndex

integer

Wajib. Indeks awal penyisipan berbasis 0 (inklusif).
endIndex

integer

Wajib. Indeks akhir penyisipan berbasis 0 (eksklusif).
inheritFromBefore

boolean

Apakah properti dimensi harus diperluas dari dimensi sebelum atau setelah dimensi yang baru disisipkan. Tetapkan ke benar (true) untuk mewarisi dari dimensi sebelumnya (dalam hal ini indeks awal harus lebih besar dari 0), dan salah (false) untuk mewarisi dari dimensi setelahnya.

Dimensi

Menunjukkan dimensi mana yang akan diterapkan oleh operasi.

Enum
DIMENSION_UNSPECIFIED Nilai default, jangan gunakan.
COLUMNS Beroperasi pada kolom sheet.
ROWS Beroperasi pada baris sheet.

Skema Output

Mewakili objek JSON.

Peta nilai kunci yang tidak berurutan, yang bertujuan untuk menangkap semantik objek JSON dengan sempurna. Hal ini memungkinkan penguraian payload JSON arbitrer sebagai kolom pesan dalam format ProtoJSON.

Hal ini mengikuti panduan RFC 8259 untuk JSON yang dapat dioperasikan: khususnya jenis ini tidak dapat mewakili nilai Int64 besar atau angka NaN/Infinity, karena format JSON umumnya tidak mendukung nilai tersebut dalam jenis angkanya.

Jika Anda tidak ingin menguraikan JSON arbitrer ke dalam pesan, sebaiknya gunakan pesan yang diketik kustom, bukan menggunakan jenis ini.

Struct

Representasi JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Kolom
fields

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

Peta nilai yang diketik secara dinamis dan tidak berurutan.

Objek yang berisi daftar "key": value pasangan. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representasi JSON 
{
  "key": string,
  "value": value
}
Kolom
key

string
value

value (Value format)

Nilai

Representasi JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Kolom
Kolom union kind. Jenis nilai. kind hanya dapat berupa salah satu di antara berikut:
nullValue

null

Mewakili JSON null.
numberValue

number

Mewakili angka JSON. Tidak boleh NaN, Infinity atau -Infinity, karena tidak didukung dalam JSON. Hal ini juga tidak dapat mewakili nilai Int64 besar, karena format JSON umumnya tidak mendukungnya dalam jenis angkanya.
stringValue

string

Mewakili string JSON.
boolValue

boolean

Mewakili boolean JSON (literal true atau false dalam JSON).
structValue

object (Struct format)

Mewakili objek JSON.
listValue

array (ListValue format)

Mewakili array JSON.

ListValue

Representasi JSON 
{
  "values": [
    value
  ]
}
Kolom
values[]

value (Value format)

Kolom berulang dari nilai yang diketik secara dinamis.

NullValue

Mewakili JSON null.

NullValue adalah sentinel, yang menggunakan enum dengan hanya satu nilai untuk mewakili nilai null untuk gabungan jenis Value.

Kolom jenis NullValue dengan nilai apa pun selain 0 dianggap tidak valid. Sebagian besar serializer ProtoJSON akan menampilkan Value dengan null_value yang ditetapkan sebagai JSON null, terlepas dari nilai bilangan bulat, dan akan melakukan perjalanan pulang pergi ke nilai 0.

Enum
NULL_VALUE Nilai null.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ✅

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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