MCP Tools Reference: sheetsmcp.googleapis.com

Araç: update_spreadsheet

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

REST API'deki spreadsheets.batchUpdate yöntemine 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. Şema:
  • properties (nesne, zorunlu): Güncellenecek e-tablo özellikleri ({"title": string, "locale": string, "timeZone": string}).
  • fields (dize, zorunlu): Güncellenecek özelliklerin alan maskesi (ör. "title" veya "*").
  • updateSheetProperties: Bir sayfanın özelliklerini günceller. Şema:
  • properties (nesne, zorunlu): Sayfa özellikleri ({"sheetId": int, "title": string, "index": int, "gridProperties": {"rowCount": int, "columnCount": int, "frozenRowCount": int, "frozenColumnCount": int, "hideGridlines": bool}, "hidden": bool, "tabColorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}}).
  • fields (dize, zorunlu): Güncellenecek özelliklerin alan maskesi (ör. "title", "gridProperties.frozenRowCount").
  • updateDimensionProperties: Boyutların özelliklerini (ör. satır yüksekliği veya sütun genişliği) günceller. Şema:
  • range (nesne, zorunlu): Boyut aralığı ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • properties (nesne, zorunlu): Boyut özellikleri ({"pixelSize": int, "hiddenByUser": bool}).
  • fields (dize, zorunlu): Güncellenecek özelliklerin alan maskesi (ör. "pixelSize").
  • updateNamedRange: Adlandırılmış bir aralığı günceller. Şema:
  • namedRange (nesne, zorunlu): Adlandırılmış aralık tanımı ({"namedRangeId": string, "name": string, "range": {"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}}).
  • fields (dize, zorunlu): Güncellenecek alanların alan maskesi (ör. "name,range" veya "*").
  • repeatCell: Tek bir hücreyi bir aralıkta tekrarlar. Şema:
  • range (nesne, zorunlu): Hücre verilerinin/biçimlendirmesinin uygulanacağı ızgara aralığı ({"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}).
  • cell (nesne, zorunlu): Hücre verileri ({"userEnteredValue": {"stringValue": str, "numberValue": float, "formulaValue": str}, "userEnteredFormat": {"textFormat": {"bold": bool, "italic": bool, "fontSize": int}, "backgroundColorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}, "horizontalAlignment": "LEFT"|"CENTER"|"RIGHT", "wrapStrategy": "WRAP"|"CLIP"|"OVERFLOW_CELL"}}).
  • fields (dize, zorunlu): Güncellenecek hücre alanlarının alan maskesi (ör. "userEnteredFormat.textFormat.bold" veya "userEnteredValue").
  • addNamedRange: Adlandırılmış aralık ekler. Şema:
  • namedRange (nesne, zorunlu): Eklenecek adlandırılmış aralık ({"namedRangeId": string (optional), "name": string, "range": {"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}}).
  • deleteNamedRange: Adlandırılmış bir aralığı kimliğine göre siler. Şema:
  • namedRangeId (dize, zorunlu): Silinecek adlandırılmış aralığın kimliği.
  • addSheet: Sayfa ekler. Şema:
  • properties (nesne, isteğe bağlı): Sayfa özellikleri ({"title": string, "sheetId": int (optional), "index": int (optional), "gridProperties": {"rowCount": int, "columnCount": int}}).
  • deleteSheet: Bir sayfayı siler. Şema:
  • sheetId (tam sayı, zorunlu): Silinecek sayfanın kimliği.
  • autoFill: Mevcut verilere göre otomatik olarak daha fazla veri doldurur. Şema:
  • range (nesne, isteğe bağlı): İncelenecek ve doldurulacak aralık ({"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}).
  • sourceAndDestination (nesne, isteğe bağlı): Açık kaynak ve dolgu uzunluğu ({"source": GridRange, "dimension": "ROWS"|"COLUMNS", "fillLength": int}).
  • useAlternateSeries (Boole, isteğe bağlı): Alternatif serilerin kullanılıp kullanılmayacağı.
  • cutPaste: Verileri bir alandan kesip başka bir alana yapıştırır. Şema:
  • source (nesne, zorunlu): Kaynak kılavuz aralığı.
  • destination (nesne, zorunlu): Sol üst hedef koordinatı ({"sheetId": int, "rowIndex": int, "columnIndex": int}).
  • pasteType (dize, isteğe bağlı): "PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA".
  • copyPaste: Verileri bir alandan kopyalayıp başka bir alana yapıştırır. Şema:
  • source (nesne, zorunlu): Kaynak kılavuz aralığı.
  • destination (nesne, zorunlu): Hedef kılavuz aralığı.
  • pasteType (dize, isteğe bağlı): "PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA".
  • pasteOrientation (dize, isteğe bağlı): "NORMAL" veya "TRANSPOSE".
  • mergeCells: Hücreleri birleştirir. Şema:
  • range (nesne, zorunlu): Birleştirilecek ızgara aralığı.
  • mergeType (dize, zorunlu): "MERGE_ALL", "MERGE_COLUMNS" veya "MERGE_ROWS".
  • unmergeCells: Birleştirilen hücreleri ayırır. Şema:
  • range (nesne, zorunlu): Tüm hücrelerin birleştirilmesinin kaldırılacağı tablo aralığı.
  • updateBorders: Bir hücre aralığındaki kenarlıkları günceller. Şema:
  • range (nesne, zorunlu): Kenarlıkların güncelleneceği kılavuz aralığı.
  • top / bottom / left / right / innerHorizontal / innerVertical (nesne, isteğe bağlı): Kenarlık stili ({"style": "SOLID"|"DASHED"|"DOTTED"|"DOUBLE"|"NONE", "width": int, "colorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}}).
  • updateCells: Aynı anda birçok hücreyi günceller. Şema:
  • Alan (tam olarak bir tane gereklidir):
    • start (nesne): Sol üst koordinat ({"sheetId": int, "rowIndex": int, "columnIndex": int}).
    • range (nesne): Izgara aralığı.
  • rows (RowData dizisi, zorunlu): Hücre satırları ([{"values": [{"userEnteredValue": {"stringValue": str, "numberValue": float, "formulaValue": str}}]}]).
  • fields (dize, zorunlu): Güncellenecek hücre alanlarının alan maskesi (ör. "userEnteredValue" veya "userEnteredFormat").
  • addFilterView: Filtre görünümü ekler. Şema:
  • filter (nesne, zorunlu): Filtre görünümü tanımı ({"title": string, "range": GridRange, "criteria": map, "sortSpecs": list}).
  • appendCells: Bir sayfada veri içeren son satırdan sonra hücre ekler. Şema:
  • sheetId (tamsayı, zorunlu): Verilerin ekleneceği sayfa kimliği.
  • rows (RowData dizisi, zorunlu): Eklenecek veri satırları.
  • fields (dize, zorunlu): Alan maskesi (ör. "userEnteredValue").
  • clearBasicFilter: Sayfadaki temel filtreyi temizler. Şema:
  • sheetId (tam sayı, zorunlu): Temel filtrenin temizleneceği sayfa kimliği.
  • deleteDimension: Sayfadaki satır veya sütunları siler. Şema:
  • range (nesne, zorunlu): Silinecek boyut aralığı ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • deleteEmbeddedObject: E-tablodaki yerleştirilmiş bir nesneyi (ör. grafik, resim) siler. Şema:
  • objectId (tam sayı, zorunlu): Silinecek yerleştirilmiş nesnenin kimliği.
  • deleteFilterView: Bir sayfadaki filtre görünümünü siler. Şema:
  • filterId (tam sayı, zorunlu): Silinecek filtre görünümünün kimliği.
  • duplicateFilterView: Bir filtre görünümünü kopyalar. Şema:
  • filterId (tam sayı, zorunlu): Kopyalanacak filtre görünümünün kimliği.
  • duplicateSheet: Bir sayfayı kopyalar. Şema:
  • sourceSheetId (tam sayı, zorunlu): Kopyalanacak sayfa kimliği.
  • insertSheetIndex (tam sayı, isteğe bağlı): Yeni sayfanın ekleneceği sıfır tabanlı dizin.
  • newSheetId (tam sayı, isteğe bağlı): Yeni sayfanın kimliği.
  • newSheetName (dize, isteğe bağlı): Yeni sayfanın adı.
  • findReplace: Bir metnin geçtiği yerleri bulur ve başka bir metinle değiştirir. Şema:
  • find (dize, zorunlu): Aranacak değer.
  • replacement (dize, zorunlu): Değiştirme değeri.
  • Kapsam (tam olarak bir tane gereklidir):
    • range (nesne): Izgara aralığı.
    • sheetId (tam sayı): Sayfa kimliği.
    • allSheets (boole): Tüm sayfalarda arama yapmak için true.
  • matchCase / matchEntireCell / searchByRegex / includeFormulas (boole, isteğe bağlı).
  • insertDimension: Sayfaya yeni satır veya sütun ekler. Şema:
  • range (nesne, zorunlu): Eklenecek boyut aralığı ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • inheritFromBefore (Boole, isteğe bağlı): Önceki satırdan/sütundan biçimlendirmeyi devralmak için true.
  • insertRange: Sayfaya yeni hücreler ekleyerek mevcut hücreleri kaydırır. Şema:
  • range (nesne, zorunlu): Hücrelerin ekleneceği tablo aralığı.
  • shiftDimension (dize, zorunlu): "ROWS" veya "COLUMNS".
  • moveDimension: Satırları veya sütunları sayfadaki başka bir konuma taşır. Şema:
  • source (nesne, zorunlu): Kaynak boyut aralığı ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • destinationIndex (tam sayı, zorunlu): Sıfır tabanlı hedef dizini.
  • updateEmbeddedObjectPosition: Yerleştirilmiş bir nesnenin (ör. grafik, resim) konumunu günceller. Şema:
  • objectId (tam sayı, zorunlu): Yerleştirilmiş nesnenin kimliği.
  • newPosition (nesne, zorunlu): Yeni konum ({"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}, "widthPixels": int, "heightPixels": int}}).
  • fields (dize, zorunlu): Alan maskesi (ör. "overlayPosition.anchorCell").
  • pasteData: Verileri (HTML veya sınırlı) bir sayfaya yapıştırır. Şema:
  • coordinate (nesne, zorunlu): Sol üst koordinat ({"sheetId": int, "rowIndex": int, "columnIndex": int}).
  • data (dize, zorunlu): Sınırlandırılmış metin veya HTML verileri.
  • delimiter (dize, isteğe bağlı) veya html (boole, isteğe bağlı).
  • type (dize, isteğe bağlı): "PASTE_NORMAL", "PASTE_VALUES" vb.
  • textToColumns: Bir metin sütununu birden fazla metin sütununa dönüştürür. Şema:
  • source (nesne, zorunlu): Tek sütunlu tablo aralığı.
  • delimiterType (dize, zorunlu): "COMMA", "SEMICOLON", "PERIOD", "SPACE", "CUSTOM", "AUTODETECT".
  • delimiter (dize, isteğe bağlı): delimiterType, "CUSTOM" olduğunda sınırlayıcı karakter.
  • updateFilterView: Bir filtre görünümünün özelliklerini günceller. Şema:
  • filter (nesne, zorunlu): filterViewId dahil olmak üzere filtre görünümü tanımı.
  • fields (dize, zorunlu): Alan maskesi (ör. "title,criteria" veya "*").
  • deleteRange: Bir sayfadaki hücre aralığını silerek kalan hücreleri kaydırır. Şema:
  • range (nesne, zorunlu): Silinecek ızgara aralığı.
  • shiftDimension (dize, zorunlu): "ROWS" veya "COLUMNS".
  • appendDimension: Boyutları bir sayfanın sonuna ekler. Şema:
  • sheetId (tam sayı, zorunlu): Sayfa kimliği.
  • dimension (dize, zorunlu): "ROWS" veya "COLUMNS".
  • length (tam sayı, zorunlu): Eklenecek satır veya sütun sayısı.
  • addConditionalFormatRule: Yeni bir koşullu biçimlendirme kuralı ekler. Şema:
  • rule (nesne, zorunlu): Koşullu biçimlendirme kuralı ({"ranges": [GridRange], "booleanRule": {"condition": {"type": "NUMBER_GREATER_THAN_EQ"|"TEXT_CONTAINS"|..., "values": [{"userEnteredValue": string}]}, "format": CellFormat}, "gradientRule": {...}}).
  • index (tam sayı, isteğe bağlı): Kuralın eklenmesi gereken sıfır tabanlı dizin.
  • updateConditionalFormatRule: Mevcut bir koşullu biçimlendirme kuralını günceller. Şema:
  • rule (nesne, zorunlu): Yeni koşullu biçimlendirme kuralı.
  • Dizin/Kural kimliği (biri zorunlu):
    • index (tam sayı): Kuralın sıfır tabanlı dizini.
    • sheetId (tam sayı): Sayfa dizinine göre güncelleme yapılıyorsa sayfa kimliği.
  • newIndex (tam sayı, isteğe bağlı): Kuralı taşımak için yeni dizin.
  • deleteConditionalFormatRule: Mevcut bir koşullu biçimlendirme kuralını siler. Şema:
  • index (tam sayı, zorunlu): Silinecek kuralın sıfır tabanlı dizini.
  • sheetId (tam sayı, zorunlu): Kuralın sayfa kimliği.
  • sortRange: Bir aralıktaki verileri sıralar. Şema:
  • range (nesne, zorunlu): Sıralanacak tablo aralığı.
  • sortSpecs (SortSpec dizisi, zorunlu): Sıralama özellikleri ([{"dimensionIndex": int, "sortOrder": "ASCENDING"|"DESCENDING"}]).
  • setDataValidation: Bir veya daha fazla hücre için veri doğrulama ayarlarını yapar. Şema:
  • range (nesne, zorunlu): Izgara aralığı.
  • rule (nesne, isteğe bağlı): Doğrulama kuralı ({"condition": {"type": "ONE_OF_LIST"|"NUMBER_BETWEEN"|..., "values": [{"userEnteredValue": string}]}, "strict": bool, "showCustomUi": bool}). Atlanırsa doğrulamayı temizler.
  • setBasicFilter: Sayfada temel filtreyi ayarlar. Şema:
  • filter (nesne, zorunlu): Temel filtre tanımı ({"range": GridRange, "criteria": map, "sortSpecs": list}).
  • addProtectedRange: Korumalı aralık ekler. Şema:
  • protectedRange (nesne, zorunlu): Korunan aralık tanımı ({"range": GridRange, "description": string, "warningOnly": bool, "editors": {"users": [string]}}).
  • updateProtectedRange: Korumalı bir aralığı günceller. Şema:
  • protectedRange (nesne, zorunlu): protectedRangeId ile korunan aralık tanımı.
  • fields (dize, zorunlu): Alan maskesi (ör. "description,warningOnly" veya "*").
  • deleteProtectedRange: Korumalı bir aralığı siler. Şema:
  • protectedRangeId (tam sayı, zorunlu): Silinecek korumalı aralığın kimliği.
  • autoResizeDimensions: Hücre içeriklerine göre bir veya daha fazla boyutu otomatik olarak yeniden boyutlandırır. Şema:
  • dimensions (nesne, zorunlu): Boyut aralığı ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • addChart: Grafik ekler. Şema:
  • chart (nesne, zorunlu): Grafik tanımı ({"spec": {"title": string, "basicChart": {"chartType": "COLUMN"|"BAR"|"LINE"|"PIE"|"COMBO"|"SCATTER", "legendPosition": string, "axis": list, "domains": list, "series": list}}, "position": {"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}}}}).
  • updateChartSpec: Bir grafiğin özelliklerini günceller. Şema:
  • chartId (tam sayı, zorunlu): Grafiğin kimliği.
  • spec (nesne, zorunlu): Yeni grafik spesifikasyonu.
  • updateBanding: Şeritli bir aralığı günceller. Şema:
  • bandedRange (nesne, zorunlu): bandedRangeId ile bantlı aralık tanımı.
  • fields (dize, zorunlu): Alan maskesi.
  • addBanding: Yeni bir şeritli aralık ekler. Şema:
  • bandedRange (nesne, zorunlu): Şeritli aralık tanımı ({"range": GridRange, "rowProperties": {"headerColorStyle": ColorStyle, "firstBandColorStyle": ColorStyle, "secondBandColorStyle": ColorStyle}}).
  • deleteBanding: Alternatif arka plan rengi aralığını kaldırır. Şema:
  • bandedRangeId (tam sayı, zorunlu): Silinecek şeritli aralığın kimliği.
  • createDeveloperMetadata: Yeni geliştirici meta verileri oluşturur. Şema:
  • developerMetadata (nesne, zorunlu): Meta veri tanımı ({"metadataKey": string, "metadataValue": string, "location": {"locationType": "ROW"|"COLUMN"|"SHEET"|"SPREADSHEET", "sheetId": int}, "visibility": "DOCUMENT"|"PROJECT"}).
  • updateDeveloperMetadata: Mevcut bir geliştirici meta veri girişini günceller. Şema:
  • dataFilters (DataFilter dizisi, zorunlu): Meta verileri seçmek için filtreler.
  • developerMetadata (nesne, zorunlu): Güncellenen meta veri değerleri.
  • fields (dize, zorunlu): Alan maskesi.
  • deleteDeveloperMetadata: Geliştirici meta verilerini siler. Şema:
  • dataFilter (nesne, zorunlu): Silinecek meta verilerin ölçütlerini açıklayan filtre.
  • randomizeRange: Bir aralıktaki satırların sırasını rastgele belirler. Şema:
  • range (nesne, zorunlu): Rastgele sıralanacak ızgara aralığı.
  • addDimensionGroup: Belirtilen aralıkta bir grup oluşturur. Şema:
  • range (nesne, zorunlu): Gruplandırılacak boyut aralığı ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • deleteDimensionGroup: Belirtilen aralıktaki bir grubu siler. Şema:
  • range (nesne, zorunlu): Silinecek grubun boyut aralığı.
  • updateDimensionGroup: Belirtilen grubun durumunu günceller. Şema:
  • dimensionGroup (nesne, zorunlu): Grup tanımı ({"range": DimensionRange, "depth": int, "collapsed": bool}).
  • fields (dize, zorunlu): Alan maskesi (ör. "collapsed").
  • trimWhitespace: Hücrelerdeki boşlukları (ör. boşluklar, sekmeler veya yeni satırlar) kaldırır. Şema:
  • range (nesne, zorunlu): Hücreleri kırpılacak tablo aralığı.
  • deleteDuplicates: Bir hücre aralığının belirtilen sütunlarında yinelenen değerler içeren satırları kaldırır. Şema:
  • range (nesne, zorunlu): Kopyaların kaldırılacağı ızgara aralığı.
  • comparisonColumns (DimensionRange dizisi, isteğe bağlı): Analiz edilecek belirli sütunlar.
  • updateEmbeddedObjectBorder: Yerleştirilmiş bir nesnenin kenarlığını günceller. Şema:
  • objectId (tam sayı, zorunlu): Yerleştirilmiş nesnenin kimliği.
  • border (nesne, zorunlu): Kenarlık tanımı ({"colorStyle": ColorStyle, "section": "ALL"}).
  • fields (dize, zorunlu): Alan maskesi.
  • addSlicer: Dilimleyici ekler. Şema:
  • slicer (nesne, zorunlu): Dilimleyici tanımı ({"spec": {"dataRange": GridRange, "columnIndex": int, "title": string}, "position": {"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}}}}).
  • updateSlicerSpec: Dilimleyicinin özelliklerini günceller. Şema:
  • slicerId (tam sayı, zorunlu): Dilimleyicinin kimliği.
  • spec (nesne, zorunlu): Yeni dilimleyici spesifikasyonu.
  • fields (dize, zorunlu): Alan maskesi.
  • addDataSource: Veri kaynağı ekler. Şema:
  • dataSource (nesne, zorunlu): Veri kaynağı tanımı ({"spec": {"bigQuery": {"projectId": string, "query": string}}}).
  • updateDataSource: Veri kaynağını günceller. Şema:
  • dataSource (nesne, zorunlu): dataSourceId ile veri kaynağı tanımı.
  • fields (dize, zorunlu): Alan maskesi.
  • deleteDataSource: Veri kaynağını siler. Şema:
  • dataSourceId (dize, zorunlu): Silinecek veri kaynağının kimliği.
  • refreshDataSource: Bir veya daha fazla veri kaynağını ve ilişkili dbobject'leri yeniler. Şema:
  • dataSourceId (dize, isteğe bağlı) veya isAll (boole, isteğe bağlı) ya da references (nesne, isteğe bağlı).
  • force (boole, isteğe bağlı): Yenilemenin zorunlu olup olmadığı.
  • cancelDataSourceRefresh: Bir veya daha fazla veri kaynağının ve ilişkili veritabanı nesnelerinin yenileme işlemlerini iptal eder. Şema:
  • dataSourceId (dize, isteğe bağlı) veya isAll (boole, isteğe bağlı) ya da references (nesne, isteğe bağlı).
  • addTable: Tablo ekler. Şema:
  • table (nesne, zorunlu): Tablo tanımı ({"range": GridRange, "name": string, "hasHeaderRow": bool, "hasTotalsRow": bool}).
  • updateTable: Tabloyu günceller. Şema:
  • table (nesne, zorunlu): tableId içeren tablo tanımı.
  • fields (dize, zorunlu): Alan maskesi.
  • deleteTable: Tablo silme isteği. Şema:
  • tableId (dize, zorunlu): Silinecek tablonun kimliği.
  • insertComment: E-tabloya yorum ekler. Şema:
  • content (dize, zorunlu): Düz metin yorum içeriği.
  • coordinate (nesne, zorunlu): Yorumun sabitleneceği sayfadaki tablo koordinatı:
    • sheetId (tam sayı, zorunlu): Sayfa kimliği.
    • rowIndex (tamsayı, zorunlu): Sıfır tabanlı satır dizini.
    • columnIndex (tam sayı, zorunlu): Sıfır tabanlı sütun dizini.
  • assigneeEmailAddress (dize, isteğe bağlı): Yorumun atandığı kullanıcının e-posta adresi.
  • addCommentReply: Mevcut bir yorum dizisine yanıt ekler. Bir mesaj dizisini çözmek veya yeniden açmak için de kullanılır. Şema:
  • commentId (dize, zorunlu): Yorum dizisinin kimliği.
  • post (nesne, zorunlu):
    • content (dize, commentAction değeri RESOLVE veya REOPEN değilse zorunlu): Yanıt yayınının düz metin içeriği.
    • commentAction (dize, isteğe bağlı): Bu yanıtla yapılan işlem ("RESOLVE" veya "REOPEN").
    • assigneeEmail (dize, isteğe bağlı): İleti dizisinin yeni atanacağı e-posta adresi.
  • updateCommentPost: Bir yorum dizisindeki yorum yayınını günceller. Şema:
  • commentId (dize, zorunlu): Yorum dizisinin kimliği.
  • postId (dize, zorunlu): Güncellenecek yorum yayınını kimliği.
  • content (dize, zorunlu): Yorum yayınındaki güncellenmiş içerik.
  • deleteComment: Bir yorum dizisini siler. Şema:
  • commentId (dize, zorunlu): Silinecek yorum dizisinin kimliği.
  • deleteCommentReply: Yanıt yayınını siler. Şema:
  • commentId (dize, zorunlu): Yorum dizisinin kimliği.
  • postId (dize, zorunlu): Silinecek yanıt yayınını kimliği.

Aşağıdaki kod örneğinde, update_spreadsheet MCP aracını çağırmak için curl öğesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://sheetsmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş şeması

UpdateContentRequest

JSON gösterimi 
{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
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 istek nesnesi olmalıdır. İstekler, belirtildikleri sırayla uygulanır. Geçersiz istekler uygulanmaz.
writeControl

object (WriteControl)

İsteğe bağlıdır. Yazma isteklerinin nasıl yürütüleceği üzerinde kontrol sağlar.

Struct

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

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

Dinamik olarak yazılan değerlerin sırasız eşlemesi.

"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 temsil edilemez.
stringValue

string

Bir JSON dizesini temsil eder.
boolValue

boolean

JSON boole değerini (JSON'da true veya false dizesi) temsil eder.
structValue

object (Struct format)

Bir 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 yazılan değerlerin yinelenen alanı.

WriteControl

JSON gösterimi 
{

  "requiredRevisionId": string
}
Alanlar
control birleşik alanı. E-tablonun yazılacak düzeltmesini ve bu düzeltme e-tablonun mevcut düzeltmesi değilse isteğin nasıl davranması gerektiğini belirler. control aşağıdakilerden yalnızca biri olabilir:
requiredRevisionId

string

Yazma isteğinin uygulanacağı e-tablonun düzeltme kimliği. Bu, dokümanın en son düzeltmesi değilse istek işlenmez ve 400 hatalı istek hatası döndürülür.

Bir yanıtta gerekli düzeltme kimliği döndürüldüğünde bu, istek uygulandıktan sonra e-tablonun düzeltme kimliğini gösterir.

NullValue

JSON null değerini temsil eder.

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

0 dışında bir değere sahip NullValue türündeki alanlar geçersiz sayılır. Ç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ı

UpdateContentResponse

JSON gösterimi 
{
  "content": {
    object
  }
}
Alanlar
content

object (Struct format)

Sheets API'nin JSON biçimindeki spreadsheets.batchUpdate yanıtı ve bir status alanı.

Struct

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

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

Dinamik olarak yazılan değerlerin sırasız eşlemesi.

"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 temsil edilemez.
stringValue

string

Bir JSON dizesini temsil eder.
boolValue

boolean

JSON boole değerini (JSON'da true veya false dizesi) temsil eder.
structValue

object (Struct format)

Bir 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 yazılan değerlerin yinelenen alanı.

NullValue

JSON null değerini temsil eder.

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

0 dışında bir değere sahip NullValue türündeki alanlar geçersiz sayılır. Ç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ç Notları

Araç notları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilir olmayan olarak değerlendirir ancak kullanıcıya ne zaman onay istemi gönderileceğine karar vermek için kullanılabilir.

Başlık dizesiyle birlikte aşağıdaki boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğru ise araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğru ise araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğru ise aracın aynı bağımsız değişkenlerle tekrar tekrar çağrılması, ortamı üzerinde ek bir etki yaratmaz. Varsayılan: false.
  • openWorldHint: Doğru ise araç, harici varlıkların "açık dünyası" ile etkileşime girebilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya iken bellek aracı açık dünya değildir.

Yıkıcı İpucu: ❌ | Bağımsız İ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