MCP Tools Reference: sheetsmcp.googleapis.com

Outil : insert_dimension

Insère des lignes ou des colonnes dans une feuille à un index particulier. Correspond à une InsertDimensionRequest dans l'API REST spreadsheets.batchUpdate : https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP insert_dimension.

Requête 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
}'

Schéma d'entrée

InsertDimensionRequest

Représentation JSON 
{
  "spreadsheetId": string,
  "sheetId": integer,
  "dimension": enum (Dimension),
  "startIndex": integer,
  "endIndex": integer,
  "inheritFromBefore": boolean
}
Champs
spreadsheetId

string

Obligatoire. ID de la feuille de calcul à mettre à jour.
sheetId

integer

Obligatoire. ID de la feuille dans laquelle insérer la feuille.
dimension

enum (Dimension)

Obligatoire. Dimension à insérer.
startIndex

integer

Obligatoire. Index de début de l'insertion (inclus), basé sur 0.
endIndex

integer

Obligatoire. Index de fin (exclusif) de l'insertion, basé sur 0.
inheritFromBefore

boolean

Indique si les propriétés de dimension doivent être étendues à partir des dimensions avant ou après les dimensions nouvellement insérées. "True" pour hériter des dimensions précédentes (dans ce cas, l'index de début doit être supérieur à 0) et "false" pour hériter des dimensions suivantes.

Dimension

Indique la dimension à laquelle une opération doit s'appliquer.

Enums
DIMENSION_UNSPECIFIED Valeur par défaut, ne pas utiliser.
COLUMNS Opère sur les colonnes d'une feuille.
ROWS Opère sur les lignes d'une feuille.

Schéma de sortie

Représente un objet JSON.

Il s'agit d'une carte clé-valeur non ordonnée, destinée à capturer parfaitement la sémantique d'un objet JSON. Cela permet d'analyser n'importe quelle charge utile JSON en tant que champ de message au format ProtoJSON.

Cela suit les consignes de la RFC 8259 pour un format JSON interopérable. Ce type ne peut notamment pas représenter de grandes valeurs Int64 ni des nombres NaN/Infinity, car le format JSON ne prend généralement pas en charge ces valeurs dans son type de nombre.

Si vous n'avez pas l'intention d'analyser du code JSON arbitraire dans votre message, il est préférable d'utiliser un message typé personnalisé plutôt que ce type.

Struct

Représentation JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Champs
fields

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

Carte non ordonnée de valeurs typées de manière dynamique.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Représentation JSON 
{
  "key": string,
  "value": value
}
Champs
key

string
value

value (Value format)

Valeur

Représentation JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Champs
Champ d'union kind. Type de valeur. kind ne peut être qu'un des éléments suivants :
nullValue

null

Représente un null JSON.
numberValue

number

Représente un nombre JSON. Ne doit pas être NaN, Infinity ni -Infinity, car ces valeurs ne sont pas acceptées dans JSON. Il ne peut pas non plus représenter de grandes valeurs Int64, car le format JSON ne les accepte généralement pas dans son type numérique.
stringValue

string

Représente une chaîne JSON.
boolValue

boolean

Représente une valeur booléenne JSON (littéral true ou false en JSON).
structValue

object (Struct format)

Représente un objet JSON.
listValue

array (ListValue format)

Représente un tableau JSON.

ListValue

Représentation JSON 
{
  "values": [
    value
  ]
}
Champs
values[]

value (Value format)

Champ répété de valeurs typées de manière dynamique.

NullValue

Représente un null JSON.

NullValue est une sentinelle qui utilise une énumération avec une seule valeur pour représenter la valeur nulle de l'union de type Value.

Un champ de type NullValue avec une valeur autre que 0 est considéré comme non valide. La plupart des sérialiseurs ProtoJSON émettent un Value avec un null_value défini comme null JSON, quelle que soit la valeur entière, et effectuent donc un aller-retour vers une valeur 0.

Enums
NULL_VALUE Valeur nulle.

Annotations d'outils

Indication de destruction : ❌ | Indication d'idempotence : ❌ | Indication de lecture seule : ❌ | Indication de monde ouvert : ✅

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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