MCP Tools Reference: sheetsmcp.googleapis.com

Strumento: update_spreadsheet

Applica uno o più aggiornamenti al foglio di lavoro.

Corrisponde a spreadsheets.batchUpdate nell'API REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

L'elenco dei possibili aggiornamenti è:

  • updateSpreadsheetProperties: aggiorna le proprietà del foglio di lavoro.
  • updateSheetProperties: aggiorna le proprietà di un foglio.
  • updateDimensionProperties: aggiorna le proprietà delle dimensioni.
  • updateNamedRange: aggiorna un intervallo denominato.
  • repeatCell: ripete una singola cella in un intervallo.
  • addNamedRange: aggiunge un intervallo denominato.
  • deleteNamedRange: Elimina un intervallo denominato.
  • addSheet: aggiunge un foglio.
  • deleteSheet: elimina un foglio.
  • autoFill: compila automaticamente più dati in base a quelli esistenti.
  • cutPaste: taglia i dati da un'area e li incolla in un'altra.
  • copyPaste: copia i dati da un'area e li incolla in un'altra.
  • mergeCells: unisce le celle.
  • unmergeCells: divide le celle unite.
  • updateBorders: aggiorna i bordi in un intervallo di celle.
  • updateCells: aggiorna molte celle contemporaneamente.
  • addFilterView: aggiunge una visualizzazione filtrata.
  • appendCells: aggiunge celle dopo l'ultima riga con dati in un foglio.
  • clearBasicFilter: cancella il filtro di base su un foglio.
  • deleteDimension: elimina righe o colonne in un foglio.
  • deleteEmbeddedObject: elimina un oggetto incorporato (ad es.grafico, immagine) in un foglio.
  • deleteFilterView: elimina una visualizzazione filtrata da un foglio.
  • duplicateFilterView: Duplica una visualizzazione filtrata.
  • duplicateSheet: duplica un foglio.
  • findReplace: trova e sostituisce le occorrenze di un testo con un altro.
  • insertDimension: inserisce nuove righe o colonne in un foglio.
  • insertRange: inserisce nuove celle in un foglio, spostando quelle esistenti.
  • moveDimension: sposta righe o colonne in un'altra posizione di un foglio.
  • updateEmbeddedObjectPosition: aggiorna la posizione di un oggetto incorporato (ad es. grafico, immagine).
  • pasteData: incolla i dati (HTML o delimitati) in un foglio.
  • textToColumns: converte una colonna di testo in più colonne di testo.
  • updateFilterView: aggiorna le proprietà di una visualizzazione filtrata.
  • deleteRange: elimina un intervallo di celle da un foglio, spostando le celle rimanenti.
  • appendDimension: aggiunge le dimensioni alla fine di un foglio.
  • addConditionalFormatRule: aggiunge una nuova regola di formattazione condizionale.
  • updateConditionalFormatRule: aggiorna una regola di formattazione condizionale esistente.
  • deleteConditionalFormatRule: elimina una regola di formattazione condizionale esistente.
  • sortRange: ordina i dati in un intervallo.
  • setDataValidation: imposta la convalida dei dati per una o più celle.
  • setBasicFilter: imposta il filtro di base su un foglio.
  • addProtectedRange: aggiunge un intervallo protetto.
  • updateProtectedRange: aggiorna un intervallo protetto.
  • deleteProtectedRange: elimina un intervallo protetto.
  • autoResizeDimensions: ridimensiona automaticamente una o più dimensioni in base ai contenuti delle celle della dimensione.
  • addChart: aggiunge un grafico.
  • updateChartSpec: aggiorna le specifiche di un grafico.
  • updateBanding: Aggiorna un intervallo a bande
  • addBanding: aggiunge un nuovo intervallo a bande
  • deleteBanding: rimuove un intervallo a bande
  • createDeveloperMetadata: Crea nuovi metadati dello sviluppatore
  • updateDeveloperMetadata: Aggiorna una voce di metadati dello sviluppatore esistente
  • deleteDeveloperMetadata: Elimina i metadati dello sviluppatore
  • randomizeRange: randomizza l'ordine delle righe in un intervallo.
  • addDimensionGroup: Crea un gruppo nell'intervallo specificato.
  • deleteDimensionGroup: elimina un gruppo nell'intervallo specificato.
  • updateDimensionGroup: Aggiorna lo stato del gruppo specificato.
  • trimWhitespace: taglia gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) nelle celle.
  • deleteDuplicates: rimuove le righe contenenti valori duplicati nelle colonne specificate di un intervallo di celle.
  • updateEmbeddedObjectBorder: Aggiorna il bordo di un oggetto incorporato.
  • addSlicer: aggiunge un controllo filtro.
  • updateSlicerSpec: aggiorna le specifiche di un selettore.
  • addDataSource: aggiunge un'origine dati.
  • updateDataSource: aggiorna un'origine dati.
  • deleteDataSource: elimina un'origine dati.
  • refreshDataSource: aggiorna una o più origini dati e gli oggetti database associati.
  • cancelDataSourceRefresh: annulla gli aggiornamenti di una o più origini dati e degli oggetti db associati.
  • addTable: aggiunge una tabella.
  • updateTable: aggiorna una tabella.
  • deleteTable: una richiesta di eliminazione di una tabella.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP update_spreadsheet.

Curl Request 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

UpdateContentRequest

Rappresentazione JSON 
{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ]
}
Campi
spreadsheetId

string

Obbligatorio. L'ID del foglio di lavoro da aggiornare.
requests[]

object (Struct format)

Obbligatorio. Un elenco di aggiornamenti da applicare al foglio di lavoro. Ogni richiesta deve essere un oggetto richiesta spreadsheets.batchUpdate valido, utilizzando lo schema documentato in: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request Le richieste verranno applicate nell'ordine in cui sono specificate. Se una richiesta non è valida, non verrà applicata alcuna richiesta.

Struct

Rappresentazione JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campi
fields

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

Mappa non ordinata di valori con tipo dinamico.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": value
}
Campi
key

string
value

value (Value format)

Valore

Rappresentazione JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Campi
Campo unione kind. Il tipo di valore. kind può essere solo uno dei seguenti tipi:
nullValue

null

Rappresenta un null JSON.
numberValue

number

Rappresenta un numero JSON. Non deve essere NaN, Infinity o -Infinity, in quanto non sono supportati in JSON. Inoltre, non può rappresentare valori Int64 di grandi dimensioni, poiché il formato JSON in genere non li supporta nel suo tipo di numero.
stringValue

string

Rappresenta una stringa JSON.
boolValue

boolean

Rappresenta un valore booleano JSON (valore letterale true o false in JSON).
structValue

object (Struct format)

Rappresenta un oggetto JSON.
listValue

array (ListValue format)

Rappresenta un array JSON.

ListValue

Rappresentazione JSON 
{
  "values": [
    value
  ]
}
Campi
values[]

value (Value format)

Campo ripetuto di valori con tipo dinamico.

NullValue

Rappresenta un null JSON.

NullValue è un sentinel che utilizza un'enumerazione con un solo valore per rappresentare il valore nullo per l'unione di tipi Value.

Un campo di tipo NullValue con un valore diverso da 0 è considerato non valido. La maggior parte dei serializzatori ProtoJSON emetterà un Value con un null_value impostato come null JSON indipendentemente dal valore intero, quindi eseguirà l'andata e il ritorno a un valore 0.

Enum
NULL_VALUE Valore nullo.

Schema di output

Rappresenta un oggetto JSON.

Una mappa chiave-valore non ordinata, pensata per acquisire perfettamente la semantica di un oggetto JSON. Ciò consente di analizzare qualsiasi payload JSON arbitrario come campo del messaggio in formato ProtoJSON.

Questo tipo segue le linee guida RFC 8259 per JSON interoperabile: in particolare, non può rappresentare valori Int64 di grandi dimensioni o numeri NaN/Infinity, poiché il formato JSON in genere non supporta questi valori nel suo tipo di numero.

Se non intendi analizzare JSON arbitrari nel messaggio, è preferibile un messaggio digitato personalizzato anziché utilizzare questo tipo.

Struct

Rappresentazione JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campi
fields

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

Mappa non ordinata di valori con tipo dinamico.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": value
}
Campi
key

string
value

value (Value format)

Valore

Rappresentazione JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Campi
Campo unione kind. Il tipo di valore. kind può essere solo uno dei seguenti tipi:
nullValue

null

Rappresenta un null JSON.
numberValue

number

Rappresenta un numero JSON. Non deve essere NaN, Infinity o -Infinity, in quanto non sono supportati in JSON. Inoltre, non può rappresentare valori Int64 di grandi dimensioni, poiché il formato JSON in genere non li supporta nel suo tipo di numero.
stringValue

string

Rappresenta una stringa JSON.
boolValue

boolean

Rappresenta un valore booleano JSON (valore letterale true o false in JSON).
structValue

object (Struct format)

Rappresenta un oggetto JSON.
listValue

array (ListValue format)

Rappresenta un array JSON.

ListValue

Rappresentazione JSON 
{
  "values": [
    value
  ]
}
Campi
values[]

value (Value format)

Campo ripetuto di valori con tipo dinamico.

NullValue

Rappresenta un null JSON.

NullValue è un sentinel che utilizza un'enumerazione con un solo valore per rappresentare il valore nullo per l'unione di tipi Value.

Un campo di tipo NullValue con un valore diverso da 0 è considerato non valido. La maggior parte dei serializzatori ProtoJSON emetterà un Value con un null_value impostato come null JSON indipendentemente dal valore intero, quindi eseguirà l'andata e il ritorno a un valore 0.

Enum
NULL_VALUE Valore nullo.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ✅