MCP Tools Reference: sheetsmcp.googleapis.com

Araç: update_spreadsheet

E-tabloda bir veya daha fazla güncelleme uygular.

REST API'deki spreadsheets.batchUpdate'e karşılık gelir: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

Olası güncellemelerin listesi:

  • updateSpreadsheetProperties: E-tablonun özelliklerini günceller.
  • updateSheetProperties: Bir sayfanın özelliklerini günceller.
  • updateDimensionProperties: Boyutların özelliklerini günceller.
  • updateNamedRange: Adlandırılmış bir aralığı günceller.
  • repeatCell: Tek bir hücreyi bir aralıkta tekrarlar.
  • addNamedRange: Adlandırılmış bir aralık ekler.
  • deleteNamedRange: Adlandırılmış bir aralığı siler.
  • addSheet: Sayfa ekler.
  • deleteSheet: Sayfayı siler.
  • autoFill: Mevcut verilere göre daha fazla veriyi otomatik olarak doldurur.
  • cutPaste: Verileri bir alandan kesip başka bir alana yapıştırır.
  • copyPaste: Verileri bir alandan kopyalayıp başka bir alana yapıştırır.
  • mergeCells: Hücreleri birleştirir.
  • unmergeCells: Birleştirilen hücreleri ayırır.
  • updateBorders: Hücre aralığındaki kenarlıkları günceller.
  • updateCells: Birçok hücreyi aynı anda günceller.
  • addFilterView: Filtre görünümü ekler.
  • appendCells: Bir sayfada veri içeren son satırdan sonraki hücreleri ekler.
  • clearBasicFilter: Bir sayfadaki temel filtreyi temizler.
  • deleteDimension: Bir sayfadaki satırları veya sütunları siler.
  • deleteEmbeddedObject: Bir sayfadaki yerleştirilmiş nesneyi (ör.grafik, resim) siler.
  • deleteFilterView: Bir sayfadaki filtre görünümünü siler.
  • duplicateFilterView: Filtre görünümünü yineler.
  • duplicateSheet: Sayfayı kopyalar.
  • findReplace: Bazı metinlerin geçtiği yerleri bulup başka metinlerle değiştirir.
  • insertDimension: Bir sayfaya yeni satırlar veya sütunlar ekler.
  • insertRange: Mevcut hücreleri kaydırarak bir sayfaya yeni hücreler ekler.
  • moveDimension: Satırları veya sütunları bir sayfada başka bir konuma taşır.
  • updateEmbeddedObjectPosition: Yerleştirilmiş bir nesnenin (ör. grafik, resim) konumunu günceller.
  • pasteData: Verileri (HTML veya sınırlanmış) bir sayfaya yapıştırır.
  • textToColumns: Bir metin sütununu birçok metin sütununa dönüştürür.
  • updateFilterView: Filtre görünümünün özelliklerini günceller.
  • deleteRange: Bir sayfadaki hücre aralığını siler ve kalan hücreleri kaydırır.
  • appendDimension: Bir sayfanın sonuna boyutlar ekler.
  • addConditionalFormatRule: Yeni bir koşullu biçim kuralı ekler.
  • updateConditionalFormatRule: Mevcut bir koşullu biçim kuralını günceller.
  • deleteConditionalFormatRule: Mevcut bir koşullu biçimlendirme kuralını siler.
  • sortRange: Bir aralıktaki verileri sıralar.
  • setDataValidation: Bir veya daha fazla hücre için veri doğrulamayı ayarlar.
  • setBasicFilter: Bir sayfada temel filtreyi ayarlar.
  • addProtectedRange: Korumalı aralık ekler.
  • updateProtectedRange: Korumalı bir aralığı günceller.
  • deleteProtectedRange: Korumalı bir aralığı siler.
  • autoResizeDimensions: Bir veya daha fazla boyutu, o boyuttaki hücrelerin içeriğine göre otomatik olarak yeniden boyutlandırır.
  • addChart: Grafik ekler.
  • updateChartSpec: Grafiğin özelliklerini günceller.
  • updateBanding: Bantlı bir aralığı günceller
  • addBanding: Yeni bir bantlı aralık ekler
  • deleteBanding: Bantlı bir aralığı kaldırır.
  • createDeveloperMetadata: Yeni geliştirici meta verileri oluşturur.
  • updateDeveloperMetadata: Mevcut bir geliştirici meta verileri girişini günceller.
  • deleteDeveloperMetadata: Geliştirici meta verilerini siler.
  • randomizeRange: Bir aralıktaki satırların sırasını rastgele hale getirir.
  • addDimensionGroup: Belirtilen aralıkta bir grup oluşturur.
  • deleteDimensionGroup: Belirtilen aralıktaki bir grubu siler.
  • updateDimensionGroup: Belirtilen grubun durumunu günceller.
  • trimWhitespace: Hücrelerdeki boşlukları (ör. boşluk, sekme veya yeni satır) kaldırır.
  • deleteDuplicates: Bir hücre aralığının belirtilen sütunlarında yinelenen değerler içeren satırları kaldırır.
  • updateEmbeddedObjectBorder: Yerleştirilmiş bir nesnenin kenarlığını günceller.
  • addSlicer: Dilimleyici ekler.
  • updateSlicerSpec: Dilimleyicinin özelliklerini günceller.
  • addDataSource: Veri kaynağı ekler.
  • updateDataSource: Veri kaynağını günceller.
  • deleteDataSource: Veri kaynağını siler.
  • refreshDataSource: Bir veya daha fazla veri kaynağını ve ilişkili dbobject'leri yeniler.
  • cancelDataSourceRefresh: Bir veya daha fazla veri kaynağının ve ilişkili dbobject'lerin yenilenmesini iptal eder.
  • addTable: Tablo ekler.
  • updateTable: Tabloyu günceller.
  • deleteTable: Tablo silme isteği.

Aşağıdaki örnekte, update_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 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

UpdateContentRequest

JSON gösterimi 
{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ]
}
Alanlar
spreadsheetId

string

Zorunlu. Güncellenecek e-tablonun kimliği.
requests[]

object (Struct format)

Zorunlu. E-tabloya uygulanacak güncellemelerin listesi. Her istek, https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request adresinde belgelenen şemayı kullanan geçerli bir spreadsheets.batchUpdate Request nesnesi olmalıdır. İstekler, belirtildikleri sırayla uygulanır. İsteklerden herhangi biri geçerli değilse hiçbir istek uygulanmaz.

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 öğesini 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

JSON dizesini temsil eder.
boolValue

boolean

JSON boole değerini (JSON'da true veya false değişmezi) 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 yinelenen alanı.

NullValue

JSON null öğesini 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 herhangi 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 null_value ile Value yayınlar ve bu nedenle 0 değerine gidiş dönüş yapar.

Sıralamalar
NULL_VALUE Boş değer.

Çı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 bu değerleri sayı türünde 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 öğesini 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

JSON dizesini temsil eder.
boolValue

boolean

JSON boole değerini (JSON'da true veya false değişmezi) 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 yinelenen alanı.

NullValue

JSON null öğesini 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 herhangi 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 null_value ile Value yayınlar ve bu nedenle 0 değerine gidiş dönüş yapar.

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