MCP Tools Reference: sheetsmcp.googleapis.com

Strumento: get_values

Restituisce un intervallo di valori da un foglio di lavoro. Corrisponde a spreadsheets.values.get nell'API REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get

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

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

Schema di input

GetValuesRequest

Rappresentazione JSON 
{
  "spreadsheetId": string,
  "range": string
}
Campi
spreadsheetId

string

Obbligatorio. L'ID del foglio di lavoro da cui recuperare i dati.
range

string

Obbligatorio. La notazione A1 o R1C1 dell'intervallo da cui recuperare i valori.

Schema di output

Dati all'interno di un intervallo del foglio di lavoro. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ValueRange

Rappresentazione JSON 
{
  "range": string,
  "values": [
    array
  ]
}
Campi
range

string

L'intervallo coperto dai valori, nella notazione A1.
values[]

array (ListValue format)

I dati letti. Si tratta di un array di array, l'array esterno che rappresenta tutti i dati e ogni array interno che rappresenta una riga. Ogni elemento dell'array interno corrisponde a una cella. Le righe e le colonne finali vuote non verranno incluse.

ListValue

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

value (Value format)

Campo ripetuto di valori con tipo dinamico.

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.

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)

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: ✅

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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