MCP Tools Reference: docsmcp.googleapis.com

Araç: update_doc

Toplu güncelleme isteklerini kullanarak bir dokümanı günceller. documents.batchUpdate isteğini (JSON olarak) kabul eder.

REST API'de documents.batchUpdate'ye karşılık gelir.

Olası güncellemelerin listesi:

  • replaceAllText: Belirtilen metnin tüm örneklerini değiştirir.
  • insertText: Belirtilen konuma metin ekler.
  • updateTextStyle: Belirtilen aralıktaki metin stilini günceller.
  • createParagraphBullets: Paragraflar için madde işaretleri oluşturur.
  • deleteParagraphBullets: Paragraflardaki madde işaretlerini siler.
  • createNamedRange: Adlandırılmış bir aralık oluşturur.
  • deleteNamedRange: Adlandırılmış bir aralığı siler.
  • updateParagraphStyle: Belirtilen aralıktaki paragraf stilini günceller.
  • deleteContentRange: Belgedeki içeriği siler.
  • insertInlineImage: Belirtilen konuma satır içi resim ekler.
  • insertTable: Belirtilen konuma bir tablo ekler.
  • insertTableRow: Tabloya boş bir satır ekler.
  • insertTableColumn: Tabloya boş bir sütun ekler.
  • deleteTableRow: Tablodaki bir satırı siler.
  • deleteTableColumn: Tablodan sütun siler.
  • insertPageBreak: Belirtilen konuma sayfa sonu ekler.
  • deletePositionedObject: Yerleştirilmiş bir nesneyi belgeden siler.
  • updateTableColumnProperties: Tablodaki sütunların özelliklerini günceller.
  • updateTableCellStyle: Tablo hücrelerinin stilini günceller.
  • updateTableRowStyle: Tablodaki satır stilini günceller.
  • replaceImage: Belgedeki bir resmi değiştirir.
  • updateDocumentStyle: Belgenin stilini günceller.
  • insertInlineSheetsChart: Belirtilen konuma satır içi bir Google E-Tablolar grafiği ekler.
  • mergeTableCells: Tablodaki hücreleri birleştirir.
  • unmergeTableCells: Tablodaki hücreleri ayırır.
  • refreshSheetsChart: Google E-Tablolar grafiğini yeniler.
  • createHeader: Başlık oluşturur.
  • createFooter: Altbilgi oluşturur.
  • createFootnote: Altbilgi oluşturur.
  • replaceNamedRangeContent: Adlandırılmış bir aralıktaki içeriği değiştirir.
  • updateEmbeddedObject: Yerleştirilmiş bir nesnenin özelliklerini günceller.
  • updateSectionStyle: Belirtilen aralığın bölüm stilini günceller.
  • insertSectionBreak: Belirtilen konuma bölüm sonu ekler.
  • deleteHeader: Belgeden bir başlığı siler.
  • deleteFooter: Dokümandaki altbilgiyi siler.
  • pinTableHeaderRows: Tablodaki sabitlenmiş başlık satırlarının sayısını günceller.
  • addDocumentTab: Belge sekmesi ekler.
  • deleteTab: Belge sekmesini siler.
  • updateDocumentTabProperties: Bir doküman sekmesinin özelliklerini günceller.
  • insertPerson: Kişi bahsetmesi ekler.
  • updateNamedStyle: Adlandırılmış bir stili günceller.
  • insertRichLink: Zengin bağlantı ekleyin.
  • insertDate: Tarih ekler.
  • insertComment: Belgeye bir CommentThread ekler.
  • addCommentReply: CommentThread veya SuggestionThread'e yanıt ekler.
  • updateCommentPost: Bir CommentThread veya SuggestionThread'in mevcut bir yayınını (ana yayın veya yanıt) günceller.
  • deleteComment: Bir CommentThread'i siler.
  • deleteCommentReply: Bir CommentThread veya SuggestionThread'den yanıt gönderisini siler.
  • acceptSuggestion: Öneriyi kabul eder.
  • rejectSuggestion: Öneriyi reddeder.
  • deleteSuggestion: Öneriyi siler.

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

Curl İsteği 
curl --location 'https://docsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_doc",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

UpdateDocRequest

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

string

Zorunlu. Güncellenecek dokümanın kimliği. Bu, Drive araçlarındaki file_id ile aynıdır.
requests[]

object (Struct format)

Belgeye uygulanacak güncellemelerin listesi. Her istek, https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request adresinde belgelenen şema kullanılarak geçerli bir documents.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 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.

Çıkış Şeması

UpdateDocResponse

JSON gösterimi 
{
  "replies": [
    {
      object
    }
  ]
}
Alanlar
replies[]

object (Struct format)

Toplu güncelleme isteklerinin yürütülmesinden elde edilen yanıtlar. Modelin ayarlamalar yapmasına yardımcı olmak için hataları, uyarıları ve ham API yanıtlarını içerir. Ham API yanıtları, https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/response adresinde belgelenen şemayı kullanır.

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