MCP Tools Reference: docsmcp.googleapis.com

Tool: update_doc

Aktualisiert ein Dokument mit Batch-Update-Anfragen. Sie akzeptiert eine documents.batchUpdate-Anfrage (als JSON).

Entspricht documents.batchUpdate in der REST API.

Die Liste der möglichen Updates:

  • replaceAllText: Ersetzt alle Instanzen des angegebenen Texts.
  • insertText: Fügt Text an der angegebenen Stelle ein.
  • updateTextStyle: Aktualisiert den Textstil im angegebenen Bereich.
  • createParagraphBullets: Erstellt Aufzählungszeichen für Absätze.
  • deleteParagraphBullets: Entfernt Aufzählungszeichen aus Absätzen.
  • createNamedRange: Erstellt einen benannten Bereich.
  • deleteNamedRange: Löscht einen benannten Bereich.
  • updateParagraphStyle: Aktualisiert den Absatzstil im angegebenen Bereich.
  • deleteContentRange: Löscht Inhalte aus dem Dokument.
  • insertInlineImage: Fügt an der angegebenen Stelle ein Inlinebild ein.
  • insertTable: Fügt eine Tabelle an der angegebenen Stelle ein.
  • insertTableRow: Fügt eine leere Zeile in eine Tabelle ein.
  • insertTableColumn: Fügt eine leere Spalte in eine Tabelle ein.
  • deleteTableRow: Löscht eine Zeile aus einer Tabelle.
  • deleteTableColumn: Löscht eine Spalte aus einer Tabelle.
  • insertPageBreak: Fügt an der angegebenen Stelle einen Seitenumbruch ein.
  • deletePositionedObject: Löscht ein positioniertes Objekt aus dem Dokument.
  • updateTableColumnProperties: Aktualisiert die Eigenschaften von Spalten in einer Tabelle.
  • updateTableCellStyle: Aktualisiert den Stil von Tabellenzellen.
  • updateTableRowStyle: Aktualisiert den Zeilenstil in einer Tabelle.
  • replaceImage: Ersetzt ein Bild im Dokument.
  • updateDocumentStyle: Aktualisiert den Stil des Dokuments.
  • insertInlineSheetsChart: Fügt an der angegebenen Stelle ein Inline-Diagramm aus Google Tabellen ein.
  • mergeTableCells: Verbindet Zellen in einer Tabelle.
  • unmergeTableCells: Hebt den Zellenverbund in einer Tabelle auf.
  • refreshSheetsChart: Aktualisiert ein Google-Tabellen-Diagramm.
  • createHeader: Erstellt eine Überschrift.
  • createFooter: Erstellt eine Fußzeile.
  • createFootnote: Erstellt eine Fußnote.
  • replaceNamedRangeContent: Ersetzt den Inhalt in einem benannten Bereich.
  • updateEmbeddedObject: Aktualisiert die Eigenschaften eines eingebetteten Objekts.
  • updateSectionStyle: Aktualisiert den Abschnittsstil des angegebenen Bereichs.
  • insertSectionBreak: Fügt an der angegebenen Stelle einen Abschnittsumbruch ein.
  • deleteHeader: Löscht eine Kopfzeile aus dem Dokument.
  • deleteFooter: Löscht eine Fußzeile aus dem Dokument.
  • pinTableHeaderRows: Aktualisiert die Anzahl der fixierten Kopfzeilen in einer Tabelle.
  • addDocumentTab: Fügt einen Dokument-Tab hinzu.
  • deleteTab: Löscht einen Dokumenttab.
  • updateDocumentTabProperties: Aktualisiert die Eigenschaften eines Dokumenttabs.
  • insertPerson: Fügt eine Erwähnung einer Person ein.
  • updateNamedStyle: Aktualisiert einen benannten Stil.
  • insertRichLink: Einen Rich-Link einfügen.
  • insertDate: Fügt ein Datum ein.
  • insertComment: Fügt einen CommentThread in das Dokument ein.
  • addCommentReply: Fügt einem CommentThread oder SuggestionThread eine Antwort hinzu.
  • updateCommentPost: Aktualisiert einen vorhandenen Beitrag (Hauptbeitrag oder Antwort) eines CommentThread oder SuggestionThread.
  • deleteComment: Löscht einen CommentThread.
  • deleteCommentReply: Löscht einen Antwortbeitrag aus einem CommentThread oder SuggestionThread.
  • acceptSuggestion: Nimmt einen Vorschlag an.
  • rejectSuggestion: Lehnt einen Vorschlag ab.
  • deleteSuggestion: Löscht einen Vorschlag.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool update_doc aufrufen.

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

Eingabeschema

UpdateDocRequest

JSON-Darstellung 
{
  "documentId": string,
  "requests": [
    {
      object
    }
  ]
}
Felder
documentId

string

Erforderlich. Die ID des zu aktualisierenden Dokuments. Dies entspricht der file_id aus Drive-Tools.
requests[]

object (Struct format)

Eine Liste der Aktualisierungen, die auf das Dokument angewendet werden sollen. Jede Anfrage muss ein gültiges documents.batchUpdate-Anfrageobjekt sein, das dem Schema entspricht, das unter https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request dokumentiert ist. Anfragen werden in der angegebenen Reihenfolge angewendet. Wenn eine Anfrage ungültig ist, werden keine Anfragen angewendet.

Struct

JSON-Darstellung 
{
  "fields": {
    string: value,
    ...
  }
}
Felder
fields

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

Ungeordnete Zuordnung von dynamisch typisierten Werten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-Darstellung 
{
  "key": string,
  "value": value
}
Felder
key

string
value

value (Value format)

Wert

JSON-Darstellung 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue

null

Stellt ein JSON-null dar.
numberValue

number

Stellt eine JSON-Zahl dar. Darf nicht NaN, Infinity oder -Infinity sein, da diese in JSON nicht unterstützt werden. Auch große Int64-Werte können nicht dargestellt werden, da das JSON-Format sie in seinem Zahlentyp generell nicht unterstützt.
stringValue

string

Stellt einen JSON-String dar.
boolValue

boolean

Stellt einen booleschen JSON-Wert dar (true- oder false-Literal in JSON).
structValue

object (Struct format)

Stellt ein JSON-Objekt dar.
listValue

array (ListValue format)

Stellt ein JSON-Array dar.

ListValue

JSON-Darstellung 
{
  "values": [
    value
  ]
}
Felder
values[]

value (Value format)

Wiederholtes Feld mit dynamisch typisierten Werten.

NullValue

Stellt ein JSON-null dar.

NullValue ist ein Sentinel, der einen Enum mit nur einem Wert verwendet, um den Nullwert für die Typunion Value darzustellen.

Ein Feld vom Typ NullValue mit einem anderen Wert als 0 gilt als ungültig. Die meisten ProtoJSON-Serialisierungsprogramme geben ein Value mit einem als JSON-null festgelegten null_value aus, unabhängig vom Ganzzahlwert. Daher wird ein Roundtrip zu einem 0-Wert durchgeführt.

Enums
NULL_VALUE Nullwert.

Ausgabeschema

UpdateDocResponse

JSON-Darstellung 
{
  "replies": [
    {
      object
    }
  ]
}
Felder
replies[]

object (Struct format)

Die Antworten auf die Batchanfragen für Updates. Enthält Fehler, Warnungen und Roh-API-Antworten, damit das Modell Anpassungen vornehmen kann. Die Roh-API-Antworten verwenden das Schema, das unter https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/response dokumentiert ist.

Struct

JSON-Darstellung 
{
  "fields": {
    string: value,
    ...
  }
}
Felder
fields

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

Ungeordnete Zuordnung von dynamisch typisierten Werten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-Darstellung 
{
  "key": string,
  "value": value
}
Felder
key

string
value

value (Value format)

Wert

JSON-Darstellung 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue

null

Stellt ein JSON-null dar.
numberValue

number

Stellt eine JSON-Zahl dar. Darf nicht NaN, Infinity oder -Infinity sein, da diese in JSON nicht unterstützt werden. Auch große Int64-Werte können nicht dargestellt werden, da das JSON-Format sie in seinem Zahlentyp generell nicht unterstützt.
stringValue

string

Stellt einen JSON-String dar.
boolValue

boolean

Stellt einen booleschen JSON-Wert dar (true- oder false-Literal in JSON).
structValue

object (Struct format)

Stellt ein JSON-Objekt dar.
listValue

array (ListValue format)

Stellt ein JSON-Array dar.

ListValue

JSON-Darstellung 
{
  "values": [
    value
  ]
}
Felder
values[]

value (Value format)

Wiederholtes Feld mit dynamisch typisierten Werten.

NullValue

Stellt ein JSON-null dar.

NullValue ist ein Sentinel, der einen Enum mit nur einem Wert verwendet, um den Nullwert für die Typunion Value darzustellen.

Ein Feld vom Typ NullValue mit einem anderen Wert als 0 gilt als ungültig. Die meisten ProtoJSON-Serialisierungsprogramme geben ein Value mit einem als JSON-null festgelegten null_value aus, unabhängig vom Ganzzahlwert. Daher wird ein Roundtrip zu einem 0-Wert durchgeführt.

Enums
NULL_VALUE Nullwert.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Nur-Lese-Hinweis: ❌ | Open-World-Hinweis: ✅