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 (come 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.

Schema di input

{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ]
}

{
  "fields": {
    string: value,
    ...
  }
}

{
  "key": string,
  "value": value
}

{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}

{
  "values": [
    value
  ]
}

Schema di output

{
  "fields": {
    string: value,
    ...
  }
}

{
  "key": string,
  "value": value
}

{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}

{
  "values": [
    value
  ]
}

Annotazioni dello strumento

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

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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