MCP Tools Reference: sheetsmcp.googleapis.com

Araç: update_spreadsheet

E-tabloya 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 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 birden fazla 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çimlendirme 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: Bantlanmış 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şluklar, sekmeler veya yeni satırlar) 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.

Giriş Şeması

{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ]
}

{
  "fields": {
    string: value,
    ...
  }
}

{
  "key": string,
  "value": value
}

{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}

{
  "values": [
    value
  ]
}

Çıkış Şeması

{
  "fields": {
    string: value,
    ...
  }
}

{
  "key": string,
  "value": value
}

{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}

{
  "values": [
    value
  ]
}

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
• https://www.googleapis.com/auth/drive.file
• https://www.googleapis.com/auth/spreadsheets