MCP Tools Reference: sheetsmcp.googleapis.com

Alat: get_values

Menampilkan rentang nilai dari spreadsheet. Sesuai dengan spreadsheets.values.get di REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP get_values.

Permintaan 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
}'

Skema Input

GetValuesRequest

Representasi JSON 
{
  "spreadsheetId": string,
  "range": string
}
Kolom
spreadsheetId

string

Wajib. ID spreadsheet tempat data akan diambil.
range

string

Wajib. Notasi A1 atau notasi R1C1 dari rentang tempat nilai akan diambil.

Skema Output

Data dalam rentang spreadsheet. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ValueRange

Representasi JSON 
{
  "range": string,
  "values": [
    array
  ]
}
Kolom
range

string

Rentang yang mencakup nilai, dalam notasi A1.
values[]

array (ListValue format)

Data yang dibaca. Ini adalah array dari array, dengan array luar mewakili semua data dan setiap array dalam mewakili baris. Setiap item dalam array dalam sesuai dengan satu sel. Baris dan kolom kosong di akhir tidak akan disertakan.

ListValue

Representasi JSON 
{
  "values": [
    value
  ]
}
Kolom
values[]

value (Value format)

Kolom berulang dari nilai yang diketik secara dinamis.

Value

Representasi JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Kolom
Kolom union kind. Jenis nilai. kind hanya dapat berupa salah satu dari berikut:
nullValue

null

Mewakili JSON null.
numberValue

number

Mewakili angka JSON. Tidak boleh NaN, Infinity atau -Infinity, karena tidak didukung dalam JSON. Hal ini juga tidak dapat mewakili nilai Int64 besar, karena format JSON umumnya tidak mendukungnya dalam jenis angka.
stringValue

string

Mewakili string JSON.
boolValue

boolean

Mewakili boolean JSON (literal true atau false dalam JSON).
structValue

object (Struct format)

Mewakili objek JSON.
listValue

array (ListValue format)

Mewakili array JSON.

Struct

Representasi JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Kolom
fields

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

Peta nilai yang diketik secara dinamis dan tidak berurutan.

Objek yang berisi daftar "key": value pasangan. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representasi JSON 
{
  "key": string,
  "value": value
}
Kolom
key

string
value

value (Value format)

NullValue

Mewakili JSON null.

NullValue adalah sentinel, menggunakan enum dengan hanya satu nilai untuk mewakili nilai null untuk gabungan jenis Value.

Kolom jenis NullValue dengan nilai apa pun selain 0 dianggap tidak valid. Sebagian besar serializer ProtoJSON akan menampilkan Value dengan null_value yang ditetapkan sebagai JSON null terlepas dari nilai bilangan bulat, dan akan melakukan round trip ke nilai 0.

Enum
NULL_VALUE Nilai null.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ✅

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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