MCP Tools Reference: sheetsmcp.googleapis.com

Alat: get_spreadsheet

Menampilkan konten spreadsheet untuk spreadsheet tertentu. Menampilkan judul, nama sheet, properti petak, dan metadata lainnya untuk ID spreadsheet tertentu. Juga menampilkan data petak lengkap jika diminta. Sesuai dengan spreadsheets.get di REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get

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

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

Skema Input

GetContentRequest

Representasi JSON 
{
  "spreadsheetId": string,
  "includeGridData": boolean
}
Kolom
spreadsheetId

string

Wajib. ID spreadsheet yang akan diminta.
includeGridData

boolean

Benar jika data petak harus ditampilkan.

Skema Output

Mewakili objek JSON.

Peta key-value yang tidak berurutan, yang dimaksudkan untuk menangkap semantik objek JSON dengan sempurna. Hal ini memungkinkan penguraian payload JSON arbitrer sebagai kolom pesan dalam format ProtoJSON.

Hal ini mengikuti pedoman RFC 8259 untuk JSON yang dapat dioperasikan: terutama jenis ini tidak dapat merepresentasikan nilai Int64 besar atau angka NaN/Infinity, karena format JSON umumnya tidak mendukung nilai tersebut dalam jenis angka.

Jika Anda tidak berniat mengurai JSON arbitrer ke dalam pesan, sebaiknya gunakan pesan yang diketik kustom daripada menggunakan jenis ini.

Struct

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

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

Peta tidak berurutan dari nilai yang diketik secara dinamis.

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

FieldsEntry

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

string
value

value (Value format)

Nilai

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 merepresentasikan nilai Int64 yang 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.

ListValue

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

value (Value format)

Kolom berulang dari nilai yang diketik secara dinamis.

NullValue

Mewakili JSON null.

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

Kolom berjenis NullValue dengan nilai selain 0 dianggap tidak valid. Sebagian besar serializer ProtoJSON akan memancarkan Value dengan null_value yang ditetapkan sebagai null JSON, terlepas dari nilai bilangan bulatnya, dan akan melakukan perjalanan pulang pergi ke nilai 0.

Enum
NULL_VALUE Nilai null.

Anotasi Alat

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