MCP Tools Reference: docsmcp.googleapis.com

Alat: update_doc

Memperbarui dokumen menggunakan permintaan update batch. API ini menerima permintaan documents.batchUpdate (sebagai JSON).

Sesuai dengan documents.batchUpdate di REST API.

Daftar kemungkinan update adalah:

  • replaceAllText: Mengganti semua instance teks yang ditentukan.
  • insertText: Menyisipkan teks di lokasi yang ditentukan.
  • updateTextStyle: Memperbarui gaya teks pada rentang yang ditentukan.
  • createParagraphBullets: Membuat butir untuk paragraf.
  • deleteParagraphBullets: Menghapus butir dari paragraf.
  • createNamedRange: Membuat rentang bernama.
  • deleteNamedRange: Menghapus rentang bernama.
  • updateParagraphStyle: Memperbarui gaya paragraf pada rentang yang ditentukan.
  • deleteContentRange: Menghapus konten dari dokumen.
  • insertInlineImage: Menyisipkan gambar inline di lokasi yang ditentukan.
  • insertTable: Menyisipkan tabel di lokasi yang ditentukan.
  • insertTableRow: Menyisipkan baris kosong ke dalam tabel.
  • insertTableColumn: Menyisipkan kolom kosong ke dalam tabel.
  • deleteTableRow: Menghapus baris dari tabel.
  • deleteTableColumn: Menghapus kolom dari tabel.
  • insertPageBreak: Menyisipkan jeda halaman di lokasi yang ditentukan.
  • deletePositionedObject: Menghapus objek yang diposisikan dari dokumen.
  • updateTableColumnProperties: Memperbarui properti kolom dalam tabel.
  • updateTableCellStyle: Memperbarui gaya sel tabel.
  • updateTableRowStyle: Memperbarui gaya baris dalam tabel.
  • replaceImage: Mengganti gambar dalam dokumen.
  • updateDocumentStyle: Memperbarui gaya dokumen.
  • insertInlineSheetsChart: Menyisipkan diagram Google Spreadsheet inline di lokasi yang ditentukan.
  • mergeTableCells: Menggabungkan sel dalam tabel.
  • unmergeTableCells: Memisahkan sel dalam tabel.
  • refreshSheetsChart: Memuat ulang diagram Google Spreadsheet.
  • createHeader: Membuat header.
  • createFooter: Membuat footer.
  • createFootnote: Membuat catatan kaki.
  • replaceNamedRangeContent: Mengganti konten dalam rentang bernama.
  • updateEmbeddedObject: Memperbarui properti objek sematan.
  • updateSectionStyle: Memperbarui gaya bagian dari rentang yang ditentukan.
  • insertSectionBreak: Menyisipkan jeda bagian di lokasi yang ditentukan.
  • deleteHeader: Menghapus header dari dokumen.
  • deleteFooter: Menghapus footer dari dokumen.
  • pinTableHeaderRows: Memperbarui jumlah baris header yang disematkan dalam tabel.
  • addDocumentTab: Menambahkan tab dokumen.
  • deleteTab: Menghapus tab dokumen.
  • updateDocumentTabProperties: Memperbarui properti tab dokumen.
  • insertPerson: Menyisipkan sebutan orang.
  • updateNamedStyle: Memperbarui gaya bernama.
  • insertRichLink: Menyisipkan link kaya.
  • insertDate: Menyisipkan tanggal.
  • insertComment: Menyisipkan CommentThread ke dalam dokumen.
  • addCommentReply: Menambahkan balasan ke CommentThread atau SuggestionThread.
  • updateCommentPost: Memperbarui postingan yang ada (postingan utama atau balasan) CommentThread atau SuggestionThread.
  • deleteComment: Menghapus CommentThread.
  • deleteCommentReply: Menghapus Postingan balasan dari CommentThread atau SuggestionThread.
  • acceptSuggestion: Menerima saran.
  • rejectSuggestion: Menolak saran.
  • deleteSuggestion: Menghapus saran.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP update_doc.

Permintaan Curl 
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
}'

Skema Input

UpdateDocRequest

Representasi JSON 
{
  "documentId": string,
  "requests": [
    {
      object
    }
  ]
}
Kolom
documentId

string

Wajib. ID dokumen yang akan diperbarui. Ini sama dengan file_id dari alat Drive.
requests[]

object (Struct format)

Daftar pembaruan yang akan diterapkan pada dokumen. Setiap permintaan harus berupa objek dokumen.batchUpdate Request yang valid, menggunakan skema yang didokumentasikan di: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request Permintaan akan diterapkan dalam urutan yang ditentukan. Jika ada permintaan yang tidak valid, tidak ada permintaan yang akan diterapkan.

Struct

Representasi JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Kolom
fields

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

Peta tidak berurutan dari nilai yang diketik secara dinamis.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representasi JSON 
{
  "key": string,
  "value": value
}
Kolom
key

string
value

value (Value format)

Nilai

Representasi JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Kolom
Kolom union kind. Jenis nilai. kind hanya dapat berupa salah satu dari berikut:
nullValue

null

Mewakili null JSON.
numberValue

number

Mewakili angka JSON. Tidak boleh NaN, Infinity, atau -Infinity, karena tidak didukung dalam JSON. Hal ini juga tidak dapat merepresentasikan nilai Int64 besar, karena format JSON umumnya tidak mendukungnya dalam jenis angka.
stringValue

string

Mewakili string JSON.
boolValue

boolean

Mewakili boolean JSON (literal true atau false dalam JSON).
structValue

object (Struct format)

Mewakili objek JSON.
listValue

array (ListValue format)

Mewakili array JSON.

ListValue

Representasi JSON 
{
  "values": [
    value
  ]
}
Kolom
values[]

value (Value format)

Kolom berulang dari nilai yang diketik secara dinamis.

NullValue

Mewakili null JSON.

NullValue adalah sentinel, menggunakan enum dengan hanya satu nilai untuk merepresentasikan nilai null untuk gabungan jenis Value.

Kolom berjenis NullValue dengan nilai selain 0 dianggap tidak valid. Sebagian besar serializer ProtoJSON akan memancarkan Value dengan null_value yang ditetapkan sebagai null JSON, terlepas dari nilai bilangan bulatnya, dan akan melakukan perjalanan pulang pergi ke nilai 0.

Enum
NULL_VALUE Nilai null.

Skema Output

UpdateDocResponse

Representasi JSON 
{
  "replies": [
    {
      object
    }
  ]
}
Kolom
replies[]

object (Struct format)

Balasan dari eksekusi permintaan update batch. Mencakup error, peringatan, dan respons API mentah untuk membantu model melakukan penyesuaian. Respons API mentah menggunakan skema yang didokumentasikan di: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/response

Struct

Representasi JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Kolom
fields

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

Peta tidak berurutan dari nilai yang diketik secara dinamis.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representasi JSON 
{
  "key": string,
  "value": value
}
Kolom
key

string
value

value (Value format)

Nilai

Representasi JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Kolom
Kolom union kind. Jenis nilai. kind hanya dapat berupa salah satu dari berikut:
nullValue

null

Mewakili null JSON.
numberValue

number

Mewakili angka JSON. Tidak boleh NaN, Infinity, atau -Infinity, karena tidak didukung dalam JSON. Hal ini juga tidak dapat merepresentasikan nilai Int64 besar, karena format JSON umumnya tidak mendukungnya dalam jenis angka.
stringValue

string

Mewakili string JSON.
boolValue

boolean

Mewakili boolean JSON (literal true atau false dalam JSON).
structValue

object (Struct format)

Mewakili objek JSON.
listValue

array (ListValue format)

Mewakili array JSON.

ListValue

Representasi JSON 
{
  "values": [
    value
  ]
}
Kolom
values[]

value (Value format)

Kolom berulang dari nilai yang diketik secara dinamis.

NullValue

Mewakili null JSON.

NullValue adalah sentinel, menggunakan enum dengan hanya satu nilai untuk merepresentasikan nilai null untuk gabungan jenis Value.

Kolom berjenis NullValue dengan nilai selain 0 dianggap tidak valid. Sebagian besar serializer ProtoJSON akan memancarkan Value dengan null_value yang ditetapkan sebagai null JSON, terlepas dari nilai bilangan bulatnya, dan akan melakukan perjalanan pulang pergi ke nilai 0.

Enum
NULL_VALUE Nilai null.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ✅