MCP Tools Reference: sheetsmcp.googleapis.com

Tool: insert_dimension

Fügt Zeilen oder Spalten in ein Tabellenblatt an einem bestimmten Index ein. Entspricht einer InsertDimensionRequest in der spreadsheets.batchUpdate REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

Im folgenden Beispiel wird gezeigt, wie Sie das MCP-Tool insert_dimension mit curl aufrufen.

cURL-Anfrage 
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
}'

Eingabeschema

InsertDimensionRequest

JSON-Darstellung 
{
  "spreadsheetId": string,
  "sheetId": integer,
  "dimension": enum (Dimension),
  "startIndex": integer,
  "endIndex": integer,
  "inheritFromBefore": boolean
}
Felder
spreadsheetId

string

Erforderlich. Die ID der zu aktualisierenden Tabelle.
sheetId

integer

Erforderlich. Die ID des Tabellenblatts, in das eingefügt werden soll.
dimension

enum (Dimension)

Erforderlich. Die einzufügende Dimension.
startIndex

integer

Erforderlich. Der nullbasierte Startindex der Einfügung (einschließlich).
endIndex

integer

Erforderlich. Der nullbasierte Endindex der Einfügung (ausschließlich).
inheritFromBefore

boolean

Gibt an, ob Dimensionseigenschaften von den Dimensionen vor oder nach den neu eingefügten Dimensionen übernommen werden sollen. „True“, um von den Dimensionen davor zu übernehmen (in diesem Fall muss der Startindex größer als 0 sein), und „False“, um von den Dimensionen danach zu übernehmen.

Dimension

Gibt an, auf welche Dimension ein Vorgang angewendet werden soll.

Enums
DIMENSION_UNSPECIFIED Der Standardwert, nicht verwenden.
COLUMNS Wird auf die Spalten eines Tabellenblatts angewendet.
ROWS Wird auf die Zeilen eines Tabellenblatts angewendet.

Ausgabeschema

Stellt ein JSON-Objekt dar.

Eine ungeordnete Schlüssel/Wert-Zuordnung, die die Semantik eines JSON-Objekts perfekt erfasst. Dadurch kann eine beliebige JSON-Nutzlast als Nachrichtenfeld im ProtoJSON-Format geparst werden.

Dies entspricht den RFC 8259-Richtlinien für interoperables JSON. Insbesondere können mit diesem Typ keine großen Int64-Werte oder NaN/Infinity-Zahlen dargestellt werden, da das JSON-Format diese Werte in seinem Zahlentyp im Allgemeinen nicht unterstützt.

Wenn Sie kein beliebiges JSON in Ihre Nachricht parsen möchten, sollten Sie stattdessen eine benutzerdefinierte typisierte Nachricht verwenden.

Struct

JSON-Darstellung 
{
  "fields": {
    string: value,
    ...
  }
}
Felder
fields

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

Ungeordnete Zuordnung von dynamisch typisierten Werten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-Darstellung 
{
  "key": string,
  "value": value
}
Felder
key

string
value

value (Value format)

Value

JSON-Darstellung 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue

null

Stellt ein JSON-null dar.
numberValue

number

Stellt eine JSON-Zahl dar. Darf nicht NaN, Infinity oder -Infinity sein, da diese in JSON nicht unterstützt werden. Außerdem können damit keine großen Int64-Werte dargestellt werden, da das JSON-Format diese in seinem Zahlentyp im Allgemeinen nicht unterstützt.
stringValue

string

Stellt einen JSON-String dar.
boolValue

boolean

Stellt einen booleschen JSON-Wert dar (true oder false-Literal in JSON).
structValue

object (Struct format)

Stellt ein JSON-Objekt dar.
listValue

array (ListValue format)

Stellt ein JSON-Array dar.

ListValue

JSON-Darstellung 
{
  "values": [
    value
  ]
}
Felder
values[]

value (Value format)

Wiederkehrendes Feld mit dynamisch typisierten Werten.

NullValue

Stellt ein JSON-null dar.

NullValue ist ein Sentinel, der ein Enum mit nur einem Wert verwendet, um den Nullwert für die Union des Typs Value darzustellen.

Ein Feld vom Typ NullValue mit einem anderen Wert als 0 ist ungültig. Die meisten ProtoJSON-Serialisierer geben unabhängig vom ganzzahligen Wert ein Value mit einem auf JSON-null festgelegten null_value aus und führen so zu einem Roundtrip zu einem 0-Wert.

Enums
NULL_VALUE Nullwert.

Toolanmerkungen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ❌ | Hinweis „Offene Welt“: ✅

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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