MCP Tools Reference: docsmcp.googleapis.com

Outil : update_doc

Met à jour un document à l'aide de requêtes de mise à jour par lot. Il accepte une requête documents.batchUpdate (au format JSON).

Correspond à documents.batchUpdate dans l'API REST.

Voici la liste des mises à jour possibles :

  • replaceAllText : remplace toutes les occurrences du texte spécifié.
  • insertText : insère du texte à l'emplacement spécifié.
  • updateTextStyle : met à jour le style de texte dans la plage spécifiée.
  • createParagraphBullets : crée des puces pour les paragraphes.
  • deleteParagraphBullets : supprime les puces des paragraphes.
  • createNamedRange : crée une plage nommée.
  • deleteNamedRange : supprime une plage nommée.
  • updateParagraphStyle : met à jour le style de paragraphe dans la plage spécifiée.
  • deleteContentRange : supprime le contenu du document.
  • insertInlineImage : insère une image intégrée à l'emplacement spécifié.
  • insertTable : insère un tableau à l'emplacement spécifié.
  • insertTableRow : insère une ligne vide dans un tableau.
  • insertTableColumn : insère une colonne vide dans une table.
  • deleteTableRow : supprime une ligne d'une table.
  • deleteTableColumn : supprime une colonne d'une table.
  • insertPageBreak : insère un saut de page à l'emplacement spécifié.
  • deletePositionedObject : supprime un objet positionné du document.
  • updateTableColumnProperties : met à jour les propriétés des colonnes d'un tableau.
  • updateTableCellStyle : met à jour le style des cellules du tableau.
  • updateTableRowStyle : met à jour le style d'une ligne dans un tableau.
  • replaceImage : remplace une image dans le document.
  • updateDocumentStyle : met à jour le style du document.
  • insertInlineSheetsChart : insère un graphique Google Sheets intégré à l'emplacement spécifié.
  • mergeTableCells : fusionne les cellules d'un tableau.
  • unmergeTableCells : annule la fusion des cellules d'un tableau.
  • refreshSheetsChart : actualise un graphique Google Sheets.
  • createHeader : crée un en-tête.
  • createFooter : crée un pied de page.
  • createFootnote : crée une note de bas de page.
  • replaceNamedRangeContent : remplace le contenu d'une plage nommée.
  • updateEmbeddedObject : met à jour les propriétés d'un objet intégré.
  • updateSectionStyle : met à jour le style de section de la plage spécifiée.
  • insertSectionBreak : insère un saut de section à l'emplacement spécifié.
  • deleteHeader : supprime un en-tête du document.
  • deleteFooter : supprime un pied de page du document.
  • pinTableHeaderRows : met à jour le nombre de lignes d'en-tête épinglées dans un tableau.
  • addDocumentTab : ajoute un onglet de document.
  • deleteTab : supprime un onglet de document.
  • updateDocumentTabProperties : met à jour les propriétés d'un onglet de document.
  • insertPerson : insère une mention de personne.
  • updateNamedStyle : met à jour un style nommé.
  • insertRichLink : insérer un lien enrichi.
  • insertDate : insère une date.
  • insertComment : insère un CommentThread dans le document.
  • addCommentReply : ajoute une réponse à un CommentThread ou un SuggestionThread.
  • updateCommentPost : met à jour un post existant (post principal ou réponse) d'un CommentThread ou d'un SuggestionThread.
  • deleteComment : supprime un CommentThread.
  • deleteCommentReply : supprime un post de réponse d'un CommentThread ou d'un SuggestionThread.
  • acceptSuggestion : accepte une suggestion.
  • rejectSuggestion : refuse une suggestion.
  • deleteSuggestion : supprime une suggestion.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP update_doc.

Requête 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
}'

Schéma d'entrée

UpdateDocRequest

Représentation JSON 
{
  "documentId": string,
  "requests": [
    {
      object
    }
  ]
}
Champs
documentId

string

Obligatoire. ID du document à mettre à jour. Il s'agit du même ID que file_id dans les outils Drive.
requests[]

object (Struct format)

Liste des mises à jour à appliquer au document. Chaque requête doit être un objet documents.batchUpdate valide, en utilisant le schéma documenté à l'adresse https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request. Les requêtes seront appliquées dans l'ordre dans lequel elles sont spécifiées. Si une demande n'est pas valide, aucune demande ne sera appliquée.

Struct

Représentation JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Champs
fields

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

Carte non ordonnée de valeurs typées de manière dynamique.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Représentation JSON 
{
  "key": string,
  "value": value
}
Champs
key

string
value

value (Value format)

Valeur

Représentation JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Champs
Champ d'union kind. Type de valeur. kind ne peut être qu'un des éléments suivants :
nullValue

null

Représente un null JSON.
numberValue

number

Représente un nombre JSON. Ne doit pas être NaN, Infinity ni -Infinity, car ces valeurs ne sont pas acceptées dans JSON. Il ne peut pas non plus représenter de grandes valeurs Int64, car le format JSON ne les accepte généralement pas dans son type numérique.
stringValue

string

Représente une chaîne JSON.
boolValue

boolean

Représente une valeur booléenne JSON (littéral true ou false en JSON).
structValue

object (Struct format)

Représente un objet JSON.
listValue

array (ListValue format)

Représente un tableau JSON.

ListValue

Représentation JSON 
{
  "values": [
    value
  ]
}
Champs
values[]

value (Value format)

Champ répété de valeurs typées de manière dynamique.

NullValue

Représente un null JSON.

NullValue est une sentinelle qui utilise une énumération avec une seule valeur pour représenter la valeur nulle de l'union de type Value.

Un champ de type NullValue avec une valeur autre que 0 est considéré comme non valide. La plupart des sérialiseurs ProtoJSON émettent un Value avec un null_value défini comme null JSON, quelle que soit la valeur entière, et effectuent donc un aller-retour vers une valeur 0.

Enums
NULL_VALUE Valeur nulle.

Schéma de sortie

UpdateDocResponse

Représentation JSON 
{
  "replies": [
    {
      object
    }
  ]
}
Champs
replies[]

object (Struct format)

Réponses à l'exécution des requêtes de mise à jour par lot. Inclut les erreurs, les avertissements et les réponses brutes de l'API pour aider le modèle à s'adapter. Les réponses brutes de l'API utilisent le schéma documenté à l'adresse https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/response.

Struct

Représentation JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Champs
fields

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

Carte non ordonnée de valeurs typées de manière dynamique.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Représentation JSON 
{
  "key": string,
  "value": value
}
Champs
key

string
value

value (Value format)

Valeur

Représentation JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Champs
Champ d'union kind. Type de valeur. kind ne peut être qu'un des éléments suivants :
nullValue

null

Représente un null JSON.
numberValue

number

Représente un nombre JSON. Ne doit pas être NaN, Infinity ni -Infinity, car ces valeurs ne sont pas acceptées dans JSON. Il ne peut pas non plus représenter de grandes valeurs Int64, car le format JSON ne les accepte généralement pas dans son type numérique.
stringValue

string

Représente une chaîne JSON.
boolValue

boolean

Représente une valeur booléenne JSON (littéral true ou false en JSON).
structValue

object (Struct format)

Représente un objet JSON.
listValue

array (ListValue format)

Représente un tableau JSON.

ListValue

Représentation JSON 
{
  "values": [
    value
  ]
}
Champs
values[]

value (Value format)

Champ répété de valeurs typées de manière dynamique.

NullValue

Représente un null JSON.

NullValue est une sentinelle qui utilise une énumération avec une seule valeur pour représenter la valeur nulle de l'union de type Value.

Un champ de type NullValue avec une valeur autre que 0 est considéré comme non valide. La plupart des sérialiseurs ProtoJSON émettent un Value avec un null_value défini comme null JSON, quelle que soit la valeur entière, et effectuent donc un aller-retour vers une valeur 0.

Enums
NULL_VALUE Valeur nulle.

Annotations d'outils

Indication de destruction : ❌ | Indication d'idempotence : ❌ | Indication de lecture seule : ❌ | Indication de monde ouvert : ✅