MCP Tools Reference: docsmcp.googleapis.com

Ferramenta: update_doc

Atualiza um documento usando solicitações de atualização em lote. Ele aceita uma solicitação documents.batchUpdate (como JSON).

Corresponde a documents.batchUpdate na API REST.

A lista de possíveis atualizações é:

  • replaceAllText: substitui todas as instâncias do texto especificado.
  • insertText: insere texto no local especificado.
  • updateTextStyle: atualiza o estilo de texto no intervalo especificado.
  • createParagraphBullets: cria marcadores para parágrafos.
  • deleteParagraphBullets: exclui marcadores de parágrafos.
  • createNamedRange: cria um intervalo nomeado.
  • deleteNamedRange: exclui um intervalo nomeado.
  • updateParagraphStyle: atualiza o estilo de parágrafo no intervalo especificado.
  • deleteContentRange: exclui conteúdo do documento.
  • insertInlineImage: insere uma imagem inline no local especificado.
  • insertTable: insere uma tabela no local especificado.
  • insertTableRow: insere uma linha vazia em uma tabela.
  • insertTableColumn: insere uma coluna vazia em uma tabela.
  • deleteTableRow: exclui uma linha de uma tabela.
  • deleteTableColumn: exclui uma coluna de uma tabela.
  • insertPageBreak: insere uma quebra de página no local especificado.
  • deletePositionedObject: exclui um objeto posicionado do documento.
  • updateTableColumnProperties: atualiza as propriedades das colunas em uma tabela.
  • updateTableCellStyle: atualiza o estilo das células da tabela.
  • updateTableRowStyle: atualiza o estilo da linha em uma tabela.
  • replaceImage: substitui uma imagem no documento.
  • updateDocumentStyle: atualiza o estilo do documento.
  • insertInlineSheetsChart: insere um gráfico inline das Planilhas Google no local especificado.
  • mergeTableCells: mescla células em uma tabela.
  • unmergeTableCells: cancela a mesclagem de células em uma tabela.
  • refreshSheetsChart: atualiza um gráfico das Planilhas Google.
  • createHeader: cria um cabeçalho.
  • createFooter: cria um rodapé.
  • createFootnote: cria uma nota de rodapé.
  • replaceNamedRangeContent: substitui o conteúdo em um intervalo nomeado.
  • updateEmbeddedObject: atualiza as propriedades de um objeto incorporado.
  • updateSectionStyle: atualiza o estilo da seção do intervalo especificado.
  • insertSectionBreak: insere uma quebra de seção no local especificado.
  • deleteHeader: exclui um cabeçalho do documento.
  • deleteFooter: exclui um rodapé do documento.
  • pinTableHeaderRows: atualiza o número de linhas de cabeçalho fixadas em uma tabela.
  • addDocumentTab: adiciona uma guia de documento.
  • deleteTab: exclui uma guia de documento.
  • updateDocumentTabProperties: atualiza as propriedades de uma guia de documento.
  • insertPerson: insere uma menção a uma pessoa.
  • updateNamedStyle: atualiza um estilo nomeado.
  • insertRichLink: insira um link avançado.
  • insertDate: insere uma data.
  • insertComment: insere um CommentThread no documento.
  • addCommentReply: adiciona uma resposta a um CommentThread ou SuggestionThread.
  • updateCommentPost: atualiza uma postagem (principal ou resposta) de um CommentThread ou SuggestionThread.
  • deleteComment: exclui um CommentThread.
  • deleteCommentReply: exclui uma postagem de resposta de um CommentThread ou SuggestionThread.
  • acceptSuggestion: aceita uma sugestão.
  • rejectSuggestion: rejeita uma sugestão.
  • deleteSuggestion: exclui uma sugestão.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta update_doc MCP.

Solicitação curl
curl --location 'https://docsmcp.googleapis.com/mcp' \
--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_doc",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

Esquema de entrada

UpdateDocRequest

Representação JSON
{
  "documentId": string,
  "requests": [
    {
      object
    }
  ]
}
Campos
documentId

string

Obrigatório. O ID do documento a ser atualizado. É o mesmo que "file_id" das ferramentas do Drive.

requests[]

object (Struct format)

Uma lista de atualizações a serem aplicadas ao documento. Cada solicitação precisa ser um objeto Request válido de "documents.batchUpdate", usando o esquema documentado em: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request. As solicitações serão aplicadas na ordem em que forem especificadas. Se alguma solicitação não for válida, nenhuma será aplicada.

Struct

Representação JSON
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

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

Mapa não ordenado de valores com tipagem dinâmica.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representação JSON
{
  "key": string,
  "value": value
}
Campos
key

string

value

value (Value format)

Valor

Representação JSON
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Campos
Campo de união kind. O tipo de valor. kind pode ser apenas de um dos tipos a seguir:
nullValue

null

Representa um null JSON.

numberValue

number

Representa um número JSON. Não pode ser NaN, Infinity ou -Infinity, porque esses valores não são compatíveis com JSON. Isso também não pode representar valores Int64 grandes, já que o formato JSON geralmente não os aceita no tipo de número.

stringValue

string

Representa uma string JSON.

boolValue

boolean

Representa um booleano JSON (literal true ou false em JSON).

structValue

object (Struct format)

Representa um objeto JSON.

listValue

array (ListValue format)

Representa uma matriz JSON.

ListValue

Representação JSON
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Campo repetido de valores digitados dinamicamente.

NullValue

Representa um null JSON.

NullValue é um sentinela que usa uma enumeração com apenas um valor para representar o valor nulo da união de tipos Value.

Um campo do tipo NullValue com qualquer valor diferente de 0 é considerado inválido. A maioria dos serializadores ProtoJSON vai emitir um Value com um null_value definido como um null JSON, independente do valor inteiro, e, portanto, fará uma viagem de ida e volta para um valor 0.

Tipos enumerados
NULL_VALUE Valor nulo.

Esquema de saída

UpdateDocResponse

Representação JSON
{
  "replies": [
    {
      object
    }
  ]
}
Campos
replies[]

object (Struct format)

As respostas da execução das solicitações de atualização em lote. Inclui erros, avisos e respostas brutas da API para ajudar o modelo a fazer ajustes. As respostas brutas da API usam o esquema documentado em: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/response

Struct

Representação JSON
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

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

Mapa não ordenado de valores com tipagem dinâmica.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representação JSON
{
  "key": string,
  "value": value
}
Campos
key

string

value

value (Value format)

Valor

Representação JSON
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Campos
Campo de união kind. O tipo de valor. kind pode ser apenas de um dos tipos a seguir:
nullValue

null

Representa um null JSON.

numberValue

number

Representa um número JSON. Não pode ser NaN, Infinity ou -Infinity, porque esses valores não são compatíveis com JSON. Isso também não pode representar valores Int64 grandes, já que o formato JSON geralmente não os aceita no tipo de número.

stringValue

string

Representa uma string JSON.

boolValue

boolean

Representa um booleano JSON (literal true ou false em JSON).

structValue

object (Struct format)

Representa um objeto JSON.

listValue

array (ListValue format)

Representa uma matriz JSON.

ListValue

Representação JSON
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Campo repetido de valores digitados dinamicamente.

NullValue

Representa um null JSON.

NullValue é um sentinela que usa uma enumeração com apenas um valor para representar o valor nulo da união de tipos Value.

Um campo do tipo NullValue com qualquer valor diferente de 0 é considerado inválido. A maioria dos serializadores ProtoJSON vai emitir um Value com um null_value definido como um null JSON, independente do valor inteiro, e, portanto, fará uma viagem de ida e volta para um valor 0.

Tipos enumerados
NULL_VALUE Valor nulo.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ✅

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/documents