MCP Tools Reference: sheetsmcp.googleapis.com

Araç: get_spreadsheet

Belirtilen e-tablonun e-tablo içeriğini döndürür. Belirtilen e-tablo kimliği için başlıkları, sayfa adlarını, ızgara özelliklerini ve diğer meta verileri döndürür. İstenirse tam ızgara verilerini de döndürür. REST API'deki spreadsheets.get'e karşılık gelir: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get

Aşağıdaki örnekte, get_spreadsheet MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

GetContentRequest

JSON gösterimi 
{
  "spreadsheetId": string,
  "includeGridData": boolean
}
Alanlar
spreadsheetId

string

Zorunlu. İstek yapılacak e-tablonun kimliği.
includeGridData

boolean

Izgara verileri döndürülmelidirse doğru (true) değerini döndürür.

Çıkış Şeması

JSON nesnesini temsil eder.

Bir JSON nesnesinin semantiğini mükemmel şekilde yakalamayı amaçlayan, sırasız bir anahtar-değer eşlemesi. Bu, rastgele JSON yüklerinin ProtoJSON biçiminde mesaj alanı olarak ayrıştırılmasını sağlar.

Bu, birlikte çalışabilir JSON için RFC 8259 yönergelerine uygundur: Özellikle, JSON biçimi genellikle sayı türünde bu değerleri desteklemediğinden bu tür, büyük Int64 değerlerini veya NaN/Infinity sayılarını temsil edemez.

Mesajınızda rastgele JSON ayrıştırmak istemiyorsanız bu türü kullanmak yerine özel türde bir mesaj tercih edilmelidir.

Struct

JSON gösterimi 
{
  "fields": {
    string: value,
    ...
  }
}
Alanlar
fields

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

Dinamik olarak türü belirlenmiş değerlerin sırasız haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON gösterimi 
{
  "key": string,
  "value": value
}
Alanlar
key

string
value

value (Value format)

Değer

JSON gösterimi 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Alanlar
kind birleşik alanı. Değer türü. kind aşağıdakilerden yalnızca biri olabilir:
nullValue

null

JSON null değerini temsil eder.
numberValue

number

JSON sayısını temsil eder. JSON'da desteklenmediği için NaN, Infinity veya -Infinity olmamalıdır. JSON biçimi genellikle sayı türünde büyük Int64 değerlerini desteklemediğinden bu değerler de gösterilemez.
stringValue

string

Bir JSON dizesini temsil eder.
boolValue

boolean

JSON boole değerini (JSON'da true veya false değişmez değeri) temsil eder.
structValue

object (Struct format)

JSON nesnesini temsil eder.
listValue

array (ListValue format)

Bir JSON dizisini temsil eder.

ListValue

JSON gösterimi 
{
  "values": [
    value
  ]
}
Alanlar
values[]

value (Value format)

Dinamik olarak türü belirlenen değerlerin tekrar eden alanı.

NullValue

JSON null değerini temsil eder.

NullValue, Value tür birliği için boş değeri temsil etmek üzere yalnızca bir değere sahip bir enum kullanan bir sentineldir.

0 dışında bir değere sahip NullValue türündeki bir alan geçersiz kabul edilir. Çoğu ProtoJSON serileştiricisi, tam sayı değerinden bağımsız olarak JSON null olarak ayarlanmış bir Value yayınlar ve bu nedenle 0 değerine gidiş dönüş yapar.null_value

Sıralamalar
NULL_VALUE Boş değer.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ✅

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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