MCP Tools Reference: sheetsmcp.googleapis.com

Strumento: get_spreadsheet

Restituisce i contenuti del foglio di lavoro specificato. Restituisce titoli, nomi dei fogli, proprietà della griglia e altri metadati per l'ID del foglio di lavoro specificato. Restituisce anche i dati completi della griglia, se richiesto. Corrisponde a spreadsheets.get nell'API REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get

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

Richiesta curl 
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": "get_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

GetContentRequest

Rappresentazione JSON 
{
  "spreadsheetId": string,
  "includeGridData": boolean
}
Campi
spreadsheetId

string

Obbligatorio. L'ID del foglio di lavoro da richiedere.
includeGridData

boolean

True se devono essere restituiti i dati della griglia.

Schema di output

Rappresenta un oggetto JSON.

Una mappa chiave-valore non ordinata, che ha lo scopo di acquisire perfettamente la semantica di un oggetto JSON. In questo modo è possibile analizzare qualsiasi payload JSON arbitrario come campo di messaggio in formato ProtoJSON.

Questo tipo segue le linee guida RFC 8259 per JSON interoperabile: in particolare, questo tipo 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 arbitrario nel tuo messaggio, è preferibile utilizzare un messaggio con tipo personalizzato anziché 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)

Value

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 valore null JSON.
numberValue

number

Rappresenta un numero JSON. Non deve essere NaN, Infinity o -Infinity, poiché questi valori 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 (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 valore null JSON.

NullValue è un valore sentinella che utilizza un'enum con un solo valore per rappresentare il valore null 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 e quindi eseguirà un round trip a un valore 0.

Enum
NULL_VALUE Valore null.

Annotazioni dello strumento

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