MCP Tools Reference: docsmcp.googleapis.com

Narzędzie: update_doc

Aktualizuje dokument za pomocą żądań aktualizacji zbiorczej. Akceptuje documents.batchUpdate żądanie (w formacie JSON).

Odpowiada to wartości documents.batchUpdate w interfejsie API REST.

Lista możliwych aktualizacji:

  • replaceAllText: Zastępuje wszystkie wystąpienia określonego tekstu.
  • insertText: Wstawia tekst w określonym miejscu.
  • updateTextStyle: aktualizuje styl tekstu w określonym zakresie.
  • createParagraphBullets: tworzy wypunktowania akapitów.
  • deleteParagraphBullets: usuwa wypunktowania z akapitów.
  • createNamedRange: tworzy nazwany zakres.
  • deleteNamedRange: Usuwa zakres nazwany.
  • updateParagraphStyle: aktualizuje styl akapitu w określonym zakresie.
  • deleteContentRange: Usuwa treść z dokumentu.
  • insertInlineImage: Wstawia obraz w treści w określonym miejscu.
  • insertTable: wstawia tabelę w określonym miejscu.
  • insertTableRow: wstawia pusty wiersz do tabeli.
  • insertTableColumn: wstawia pustą kolumnę do tabeli.
  • deleteTableRow: usuwa wiersz z tabeli.
  • deleteTableColumn: usuwa kolumnę z tabeli.
  • insertPageBreak: Wstawia podział strony w określonym miejscu.
  • deletePositionedObject: Usuwa z dokumentu obiekt z określonym położeniem.
  • updateTableColumnProperties: aktualizuje właściwości kolumn w tabeli.
  • updateTableCellStyle: aktualizuje styl komórek tabeli.
  • updateTableRowStyle: aktualizuje styl wiersza w tabeli.
  • replaceImage: zastępuje obraz w dokumencie.
  • updateDocumentStyle: Aktualizuje styl dokumentu.
  • insertInlineSheetsChart: wstawia w określonym miejscu wykres z Arkuszy Google.
  • mergeTableCells: scala komórki w tabeli.
  • unmergeTableCells: rozdziela komórki w tabeli.
  • refreshSheetsChart: odświeża wykres Arkuszy Google.
  • createHeader: tworzy nagłówek.
  • createFooter: tworzy stopkę.
  • createFootnote: tworzy przypis.
  • replaceNamedRangeContent: zastępuje zawartość w nazwanym zakresie.
  • updateEmbeddedObject: Aktualizuje właściwości osadzonego obiektu.
  • updateSectionStyle: aktualizuje styl sekcji w określonym zakresie.
  • insertSectionBreak: Wstawia podział sekcji w określonym miejscu.
  • deleteHeader: Usuwa nagłówek z dokumentu.
  • deleteFooter: Usuwa stopkę z dokumentu.
  • pinTableHeaderRows: aktualizuje liczbę przypiętych wierszy nagłówka w tabeli.
  • addDocumentTab: Dodaje kartę dokumentu.
  • deleteTab: Usuwa kartę dokumentu.
  • updateDocumentTabProperties: Aktualizuje właściwości karty dokumentu.
  • insertPerson: wstawia wzmiankę o osobie.
  • updateNamedStyle: aktualizuje styl o określonej nazwie.
  • insertRichLink: wstawić link z elementami rozszerzonymi.
  • insertDate: wstawia datę.
  • insertComment: Wstawia do dokumentu obiekt CommentThread.
  • addCommentReply: dodaje odpowiedź do obiektu CommentThread lub SuggestionThread.
  • updateCommentPost: aktualizuje istniejący post (główny post lub odpowiedź) w wątku komentarzy lub wątku sugestii.
  • deleteComment: usuwa obiekt CommentThread.
  • deleteCommentReply: usuwa posta z odpowiedzią z obiektu CommentThread lub SuggestionThread.
  • acceptSuggestion: akceptuje sugestię.
  • rejectSuggestion: odrzuca sugestię.
  • deleteSuggestion: usuwa sugestię.

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie update_doc MCP.

Żądanie 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
}'

Schemat danych wejściowych

UpdateDocRequest

Zapis JSON 
{
  "documentId": string,
  "requests": [
    {
      object
    }
  ]
}
Pola
documentId

string

Wymagane. Identyfikator dokumentu do zaktualizowania. Jest to ten sam identyfikator co file_id w narzędziach Dysku.
requests[]

object (Struct format)

Lista aktualizacji, które mają zostać zastosowane w dokumencie. Każde żądanie powinno być prawidłowym obiektem żądania documents.batchUpdate, korzystającym ze schematu opisanego na stronie https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request. Żądania będą stosowane w kolejności, w jakiej zostały określone. Jeśli którekolwiek żądanie jest nieprawidłowe, żadne żądanie nie zostanie zastosowane.

Struct

Zapis JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Pola
fields

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

Nieuporządkowana mapa wartości o typie dynamicznym.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

Zapis JSON 
{
  "key": string,
  "value": value
}
Pola
key

string
value

value (Value format)

Wartość

Zapis JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Pola
Pole zbiorcze kind. Rodzaj wartości. kind może mieć tylko jedną z tych wartości:
nullValue

null

Reprezentuje null JSON.
numberValue

number

Reprezentuje liczbę JSON. Nie może to być NaN, Infinity ani -Infinity, ponieważ te wartości nie są obsługiwane w formacie JSON. Nie może też reprezentować dużych wartości Int64, ponieważ format JSON zwykle nie obsługuje ich w swoim typie liczbowym.
stringValue

string

Reprezentuje ciąg JSON.
boolValue

boolean

Reprezentuje wartość logiczną JSON (literał true lub false w formacie JSON).
structValue

object (Struct format)

Reprezentuje obiekt JSON.
listValue

array (ListValue format)

Reprezentuje tablicę JSON.

ListValue

Zapis JSON 
{
  "values": [
    value
  ]
}
Pola
values[]

value (Value format)

Powtórzone pole wartości o dynamicznym typie.

NullValue

Reprezentuje null JSON.

NullValue to wartość strażnicza, która za pomocą wyliczenia z tylko jedną wartością reprezentuje wartość null dla unii typów Value.

Pole typu NullValue z wartością inną niż 0 jest uznawane za nieprawidłowe. Większość serializatorów ProtoJSON wygeneruje wartość Value z wartością null_value ustawioną jako null JSON niezależnie od wartości całkowitej, a więc będzie zaokrąglać do wartości 0.

Wartości w polu enum
NULL_VALUE Wartość null.

Schemat wyjściowy

UpdateDocResponse

Zapis JSON 
{
  "replies": [
    {
      object
    }
  ]
}
Pola
replies[]

object (Struct format)

Odpowiedzi na żądania aktualizacji zbiorczej. Obejmuje błędy, ostrzeżenia i nieprzetworzone odpowiedzi interfejsu API, które pomagają modelowi wprowadzać zmiany. Surowe odpowiedzi interfejsu API korzystają ze schematu opisanego na stronie: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/response

Struct

Zapis JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Pola
fields

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

Nieuporządkowana mapa wartości o typie dynamicznym.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

Zapis JSON 
{
  "key": string,
  "value": value
}
Pola
key

string
value

value (Value format)

Wartość

Zapis JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Pola
Pole zbiorcze kind. Rodzaj wartości. kind może mieć tylko jedną z tych wartości:
nullValue

null

Reprezentuje null JSON.
numberValue

number

Reprezentuje liczbę JSON. Nie może to być NaN, Infinity ani -Infinity, ponieważ te wartości nie są obsługiwane w formacie JSON. Nie może też reprezentować dużych wartości Int64, ponieważ format JSON zwykle nie obsługuje ich w swoim typie liczbowym.
stringValue

string

Reprezentuje ciąg JSON.
boolValue

boolean

Reprezentuje wartość logiczną JSON (literał true lub false w formacie JSON).
structValue

object (Struct format)

Reprezentuje obiekt JSON.
listValue

array (ListValue format)

Reprezentuje tablicę JSON.

ListValue

Zapis JSON 
{
  "values": [
    value
  ]
}
Pola
values[]

value (Value format)

Powtórzone pole wartości o dynamicznym typie.

NullValue

Reprezentuje null JSON.

NullValue to wartość strażnicza, która za pomocą wyliczenia z tylko jedną wartością reprezentuje wartość null dla unii typów Value.

Pole typu NullValue z wartością inną niż 0 jest uznawane za nieprawidłowe. Większość serializatorów ProtoJSON wygeneruje wartość Value z wartością null_value ustawioną jako null JSON niezależnie od wartości całkowitej, a więc będzie zaokrąglać do wartości 0.

Wartości w polu enum
NULL_VALUE Wartość null.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ✅