MCP Tools Reference: docsmcp.googleapis.com

Strumento: update_doc

Aggiorna un documento utilizzando le richieste di aggiornamento batch. Accetta una richiesta documents.batchUpdate (in formato JSON).

Corrisponde a documents.batchUpdate nell'API REST.

L'elenco dei possibili aggiornamenti è:

  • replaceAllText: sostituisce tutte le istanze del testo specificato.
  • insertText: inserisce il testo nella posizione specificata.
  • updateTextStyle: aggiorna lo stile del testo nell'intervallo specificato.
  • createParagraphBullets: crea elenchi puntati per i paragrafi.
  • deleteParagraphBullets: Elimina i punti elenco dai paragrafi.
  • createNamedRange: crea un intervallo denominato.
  • deleteNamedRange: Elimina un intervallo denominato.
  • updateParagraphStyle: aggiorna lo stile del paragrafo nell'intervallo specificato.
  • deleteContentRange: Elimina i contenuti dal documento.
  • insertInlineImage: inserisce un'immagine in linea nella posizione specificata.
  • insertTable: inserisce una tabella nella posizione specificata.
  • insertTableRow: inserisce una riga vuota in una tabella.
  • insertTableColumn: inserisce una colonna vuota in una tabella.
  • deleteTableRow: elimina una riga da una tabella.
  • deleteTableColumn: elimina una colonna da una tabella.
  • insertPageBreak: inserisce un'interruzione di pagina nella posizione specificata.
  • deletePositionedObject: Elimina un oggetto posizionato dal documento.
  • updateTableColumnProperties: aggiorna le proprietà delle colonne di una tabella.
  • updateTableCellStyle: Aggiorna lo stile delle celle della tabella.
  • updateTableRowStyle: aggiorna lo stile della riga in una tabella.
  • replaceImage: Sostituisce un'immagine nel documento.
  • updateDocumentStyle: Aggiorna lo stile del documento.
  • insertInlineSheetsChart: inserisce un grafico di Fogli Google in linea nella posizione specificata.
  • mergeTableCells: Unisce le celle di una tabella.
  • unmergeTableCells: divide le celle di una tabella.
  • refreshSheetsChart: aggiorna un grafico di Fogli Google.
  • createHeader: crea un'intestazione.
  • createFooter: crea un piè di pagina.
  • createFootnote: crea una nota a piè di pagina.
  • replaceNamedRangeContent: Sostituisce il contenuto di un intervallo denominato.
  • updateEmbeddedObject: aggiorna le proprietà di un oggetto incorporato.
  • updateSectionStyle: aggiorna lo stile della sezione dell'intervallo specificato.
  • insertSectionBreak: inserisce un'interruzione di sezione nella posizione specificata.
  • deleteHeader: elimina un'intestazione dal documento.
  • deleteFooter: Elimina un piè di pagina dal documento.
  • pinTableHeaderRows: aggiorna il numero di righe di intestazione fissate in una tabella.
  • addDocumentTab: aggiunge una scheda del documento.
  • deleteTab: Elimina una scheda del documento.
  • updateDocumentTabProperties: Aggiorna le proprietà di una scheda del documento.
  • insertPerson: inserisce una menzione di una persona.
  • updateNamedStyle: aggiorna uno stile denominato.
  • insertRichLink: inserisci un link avanzato.
  • insertDate: inserisce una data.
  • insertComment: Inserisce un CommentThread nel documento.
  • addCommentReply: aggiunge una risposta a un CommentThread o SuggestionThread.
  • updateCommentPost: aggiorna un post esistente (post principale o risposta) di un CommentThread o SuggestionThread.
  • deleteComment: elimina un CommentThread.
  • deleteCommentReply: elimina un post di risposta da un CommentThread o SuggestionThread.
  • acceptSuggestion: accetta un suggerimento.
  • rejectSuggestion: rifiuta un suggerimento.
  • deleteSuggestion: elimina un suggerimento.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP update_doc.

Richiesta 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
}'

Schema di input

UpdateDocRequest

Rappresentazione JSON 
{
  "documentId": string,
  "requests": [
    {
      object
    }
  ]
}
Campi
documentId

string

Obbligatorio. L'ID del documento da aggiornare. È lo stesso di file_id degli strumenti di Drive.
requests[]

object (Struct format)

Un elenco di aggiornamenti da applicare al documento. Ogni richiesta deve essere un oggetto Request batchUpdate valido, utilizzando lo schema documentato in: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request.Le richieste verranno applicate nell'ordine in cui sono specificate. Se una richiesta non è valida, non verrà applicata alcuna richiesta.

Struct

Rappresentazione JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campi
fields

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

Mappa non ordinata di valori con tipo dinamico.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": value
}
Campi
key

string
value

value (Value format)

Valore

Rappresentazione JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Campi
Campo unione kind. Il tipo di valore. kind può essere solo uno dei seguenti tipi:
nullValue

null

Rappresenta un null JSON.
numberValue

number

Rappresenta un numero JSON. Non deve essere NaN, Infinity o -Infinity, in quanto non sono supportati in JSON. Inoltre, non può rappresentare valori Int64 di grandi dimensioni, poiché il formato JSON in genere non li supporta nel suo tipo di numero.
stringValue

string

Rappresenta una stringa JSON.
boolValue

boolean

Rappresenta un valore booleano JSON (valore letterale true o false in JSON).
structValue

object (Struct format)

Rappresenta un oggetto JSON.
listValue

array (ListValue format)

Rappresenta un array JSON.

ListValue

Rappresentazione JSON 
{
  "values": [
    value
  ]
}
Campi
values[]

value (Value format)

Campo ripetuto di valori con tipo dinamico.

NullValue

Rappresenta un null JSON.

NullValue è un sentinel che utilizza un'enumerazione con un solo valore per rappresentare il valore nullo per l'unione di tipi Value.

Un campo di tipo NullValue con un valore diverso da 0 è considerato non valido. La maggior parte dei serializzatori ProtoJSON emetterà un Value con un null_value impostato come null JSON indipendentemente dal valore intero, quindi eseguirà l'andata e il ritorno a un valore 0.

Enum
NULL_VALUE Valore nullo.

Schema di output

UpdateDocResponse

Rappresentazione JSON 
{
  "replies": [
    {
      object
    }
  ]
}
Campi
replies[]

object (Struct format)

Le risposte all'esecuzione delle richieste di aggiornamento batch. Include errori, avvisi e risposte API non elaborate per aiutare il modello a apportare modifiche. Le risposte API non elaborate utilizzano lo schema documentato in: https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/response

Struct

Rappresentazione JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campi
fields

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

Mappa non ordinata di valori con tipo dinamico.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": value
}
Campi
key

string
value

value (Value format)

Valore

Rappresentazione JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Campi
Campo unione kind. Il tipo di valore. kind può essere solo uno dei seguenti tipi:
nullValue

null

Rappresenta un null JSON.
numberValue

number

Rappresenta un numero JSON. Non deve essere NaN, Infinity o -Infinity, in quanto non sono supportati in JSON. Inoltre, non può rappresentare valori Int64 di grandi dimensioni, poiché il formato JSON in genere non li supporta nel suo tipo di numero.
stringValue

string

Rappresenta una stringa JSON.
boolValue

boolean

Rappresenta un valore booleano JSON (valore letterale true o false in JSON).
structValue

object (Struct format)

Rappresenta un oggetto JSON.
listValue

array (ListValue format)

Rappresenta un array JSON.

ListValue

Rappresentazione JSON 
{
  "values": [
    value
  ]
}
Campi
values[]

value (Value format)

Campo ripetuto di valori con tipo dinamico.

NullValue

Rappresenta un null JSON.

NullValue è un sentinel che utilizza un'enumerazione con un solo valore per rappresentare il valore nullo per l'unione di tipi Value.

Un campo di tipo NullValue con un valore diverso da 0 è considerato non valido. La maggior parte dei serializzatori ProtoJSON emetterà un Value con un null_value impostato come null JSON indipendentemente dal valore intero, quindi eseguirà l'andata e il ritorno a un valore 0.

Enum
NULL_VALUE Valore nullo.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ✅