MCP Tools Reference: sheetsmcp.googleapis.com

Outil : update_spreadsheet

Applique une ou plusieurs mises à jour à la feuille de calcul.

Correspond à spreadsheets.batchUpdate dans l'API REST : https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

Voici la liste des mises à jour possibles :

  • updateSpreadsheetProperties : met à jour les propriétés de la feuille de calcul. Schéma :
  • properties (objet, obligatoire) : propriétés de la feuille de calcul à mettre à jour ({"title": string, "locale": string, "timeZone": string}).
  • fields (chaîne, obligatoire) : masque de champ des propriétés à mettre à jour (par exemple, "title" ou "*").
  • updateSheetProperties : met à jour les propriétés d'une feuille. Schéma :
  • properties (objet, obligatoire) : propriétés de la feuille ({"sheetId": int, "title": string, "index": int, "gridProperties": {"rowCount": int, "columnCount": int, "frozenRowCount": int, "frozenColumnCount": int, "hideGridlines": bool}, "hidden": bool, "tabColorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}}).
  • fields (chaîne, obligatoire) : masque de champ des propriétés à mettre à jour (par exemple, "title", "gridProperties.frozenRowCount").
  • updateDimensionProperties : met à jour les propriétés des dimensions (par exemple, la hauteur des lignes ou la largeur des colonnes). Schéma :
  • range (objet, obligatoire) : plage de dimensions ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • properties (objet, obligatoire) : propriétés de la dimension ({"pixelSize": int, "hiddenByUser": bool}).
  • fields (chaîne, obligatoire) : masque de champ des propriétés à mettre à jour (par exemple, "pixelSize").
  • updateNamedRange : met à jour une plage nommée. Schéma :
  • namedRange (objet, obligatoire) : définition de la plage nommée ({"namedRangeId": string, "name": string, "range": {"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}}).
  • fields (chaîne, obligatoire) : masque des champs à mettre à jour (par exemple, "name,range" ou "*").
  • repeatCell : répète une seule cellule sur une plage. Schéma :
  • range (objet, obligatoire) : plage de la grille à laquelle appliquer les données/la mise en forme des cellules ({"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}).
  • cell (objet, obligatoire) : données de cellule ({"userEnteredValue": {"stringValue": str, "numberValue": float, "formulaValue": str}, "userEnteredFormat": {"textFormat": {"bold": bool, "italic": bool, "fontSize": int}, "backgroundColorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}, "horizontalAlignment": "LEFT"|"CENTER"|"RIGHT", "wrapStrategy": "WRAP"|"CLIP"|"OVERFLOW_CELL"}}).
  • fields (chaîne, obligatoire) : masque de champ des champs de cellule à mettre à jour (par exemple, "userEnteredFormat.textFormat.bold" ou "userEnteredValue").
  • addNamedRange : ajoute une plage nommée. Schéma :
  • namedRange (objet, obligatoire) : plage nommée à ajouter ({"namedRangeId": string (optional), "name": string, "range": {"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}}).
  • deleteNamedRange : supprime une plage nommée par son ID. Schéma :
  • namedRangeId (chaîne, obligatoire) : ID de la plage nommée à supprimer.
  • addSheet : ajoute une feuille. Schéma :
  • properties (objet, facultatif) : propriétés de la feuille ({"title": string, "sheetId": int (optional), "index": int (optional), "gridProperties": {"rowCount": int, "columnCount": int}}).
  • deleteSheet : supprime une feuille. Schéma :
  • sheetId (entier, obligatoire) : ID de la feuille à supprimer.
  • autoFill : remplit automatiquement plus de données en fonction des données existantes. Schéma :
  • range (objet, facultatif) : plage à examiner et à remplir ({"sheetId": int, "startRowIndex": int, "endRowIndex": int, "startColumnIndex": int, "endColumnIndex": int}).
  • sourceAndDestination (objet, facultatif) : source explicite et longueur de remplissage ({"source": GridRange, "dimension": "ROWS"|"COLUMNS", "fillLength": int}).
  • useAlternateSeries (booléen, facultatif) : indique si vous souhaitez utiliser une autre série.
  • cutPaste : coupe les données d'une zone et les colle dans une autre. Schéma :
  • source (objet, obligatoire) : plage de la grille source.
  • destination (objet, obligatoire) : coordonnées de destination en haut à gauche ({"sheetId": int, "rowIndex": int, "columnIndex": int}).
  • pasteType (chaîne, facultatif) : "PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA".
  • copyPaste : copie les données d'une zone et les colle dans une autre. Schéma :
  • source (objet, obligatoire) : plage de la grille source.
  • destination (objet, obligatoire) : plage de la grille de destination.
  • pasteType (chaîne, facultatif) : "PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA".
  • pasteOrientation (chaîne, facultatif) : "NORMAL" ou "TRANSPOSE".
  • mergeCells : fusionne les cellules. Schéma :
  • range (objet, obligatoire) : plage de la grille à fusionner.
  • mergeType (chaîne, obligatoire) : "MERGE_ALL", "MERGE_COLUMNS" ou "MERGE_ROWS".
  • unmergeCells : annule la fusion des cellules fusionnées. Schéma :
  • range (objet, obligatoire) : plage de la grille dans laquelle annuler la fusion de toutes les cellules.
  • updateBorders : met à jour les bordures d'une plage de cellules. Schéma :
  • range (objet, obligatoire) : plage de la grille dont les bordures doivent être mises à jour.
  • top / bottom / left / right / innerHorizontal / innerVertical (objet, facultatif) : style de bordure ({"style": "SOLID"|"DASHED"|"DOTTED"|"DOUBLE"|"NONE", "width": int, "colorStyle": {"rgbColor": {"red": float, "green": float, "blue": float}}}).
  • updateCells : met à jour plusieurs cellules à la fois. Schéma :
  • Zone (une seule requise) :
    • start (objet) : coordonnées en haut à gauche ({"sheetId": int, "rowIndex": int, "columnIndex": int}).
    • range (objet) : plage de la grille.
  • rows (tableau de RowData, obligatoire) : lignes de cellules ([{"values": [{"userEnteredValue": {"stringValue": str, "numberValue": float, "formulaValue": str}}]}]).
  • fields (chaîne, obligatoire) : masque de champ des champs de cellule à mettre à jour (par exemple, "userEnteredValue" ou "userEnteredFormat").
  • addFilterView : ajoute une vue filtrée. Schéma :
  • filter (objet, obligatoire) : définition de la vue filtrée ({"title": string, "range": GridRange, "criteria": map, "sortSpecs": list}).
  • appendCells : ajoute des cellules après la dernière ligne contenant des données dans une feuille. Schéma :
  • sheetId (entier, obligatoire) : ID de la feuille à laquelle ajouter des données.
  • rows (tableau de RowData, obligatoire) : lignes de données à ajouter.
  • fields (chaîne, obligatoire) : masque de champ (par exemple, "userEnteredValue").
  • clearBasicFilter : efface le filtre de base d'une feuille. Schéma :
  • sheetId (entier, obligatoire) : ID de la feuille sur laquelle effacer le filtre de base.
  • deleteDimension : supprime des lignes ou des colonnes d'une feuille. Schéma :
  • range (objet, obligatoire) : plage de dimensions à supprimer ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • deleteEmbeddedObject : supprime un objet intégré (par exemple, un graphique ou une image) d'une feuille. Schéma :
  • objectId (entier, obligatoire) : ID de l'objet intégré à supprimer.
  • deleteFilterView : supprime une vue filtrée d'une feuille. Schéma :
  • filterId (entier, obligatoire) : ID de la vue filtrée à supprimer.
  • duplicateFilterView : duplique une vue filtrée. Schéma :
  • filterId (entier, obligatoire) : ID de la vue filtrée à dupliquer.
  • duplicateSheet : duplique une feuille. Schéma :
  • sourceSheetId (entier, obligatoire) : ID de la feuille à dupliquer.
  • insertSheetIndex (entier, facultatif) : index basé sur zéro où la nouvelle feuille doit être insérée.
  • newSheetId (entier, facultatif) : ID de la nouvelle feuille.
  • newSheetName (chaîne, facultatif) : nom de la nouvelle feuille.
  • findReplace : recherche et remplace les occurrences d'un texte par un autre. Schéma :
  • find (chaîne, obligatoire) : valeur à rechercher.
  • replacement (chaîne, obligatoire) : valeur de remplacement.
  • Champ d'application (un seul requis) :
    • range (objet) : plage de la grille.
    • sheetId (entier) : ID de la feuille.
    • allSheets (booléen) : true pour rechercher dans toutes les feuilles.
  • matchCase / matchEntireCell / searchByRegex / includeFormulas (booléen, facultatif).
  • insertDimension : insère de nouvelles lignes ou colonnes dans une feuille. Schéma :
  • range (objet, obligatoire) : plage de dimensions à insérer ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • inheritFromBefore (booléen, facultatif) : true pour hériter de la mise en forme de la ligne/colonne précédente.
  • insertRange : insère de nouvelles cellules dans une feuille, en décalant les cellules existantes. Schéma :
  • range (objet, obligatoire) : plage de la grille dans laquelle insérer des cellules.
  • shiftDimension (chaîne, obligatoire) : "ROWS" ou "COLUMNS".
  • moveDimension : déplace des lignes ou des colonnes vers un autre emplacement dans une feuille. Schéma :
  • source (objet, obligatoire) : plage de dimensions source ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • destinationIndex (entier, obligatoire) : index de destination basé sur zéro.
  • updateEmbeddedObjectPosition : met à jour la position d'un objet intégré (par exemple, un graphique ou une image). Schéma :
  • objectId (entier, obligatoire) : ID de l'objet intégré.
  • newPosition (objet, obligatoire) : nouvelle position ({"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}, "widthPixels": int, "heightPixels": int}}).
  • fields (chaîne, obligatoire) : masque de champ (par exemple, "overlayPosition.anchorCell").
  • pasteData : colle des données (HTML ou délimitées) dans une feuille. Schéma :
  • coordinate (objet, obligatoire) : coordonnées en haut à gauche ({"sheetId": int, "rowIndex": int, "columnIndex": int}).
  • data (chaîne, obligatoire) : texte délimité ou données HTML.
  • delimiter (chaîne, facultatif) ou html (booléen, facultatif).
  • type (chaîne, facultatif) : "PASTE_NORMAL", "PASTE_VALUES", etc.
  • textToColumns : convertit une colonne de texte en plusieurs colonnes de texte. Schéma :
  • source (objet, obligatoire) : plage de grille sur une seule colonne.
  • delimiterType (chaîne, obligatoire) : "COMMA", "SEMICOLON", "PERIOD", "SPACE", "CUSTOM", "AUTODETECT".
  • delimiter (chaîne, facultatif) : caractère de délimitation lorsque delimiterType est défini sur "CUSTOM".
  • updateFilterView : met à jour les propriétés d'une vue filtrée. Schéma :
  • filter (objet, obligatoire) : définition de la vue filtrée, y compris filterViewId.
  • fields (chaîne, obligatoire) : masque de champ (par exemple, "title,criteria" ou "*").
  • deleteRange : supprime une plage de cellules d'une feuille, en décalant les cellules restantes. Schéma :
  • range (objet, obligatoire) : plage de la grille à supprimer.
  • shiftDimension (chaîne, obligatoire) : "ROWS" ou "COLUMNS".
  • appendDimension : ajoute des dimensions à la fin d'une feuille. Schéma :
  • sheetId (entier, obligatoire) : ID de la feuille.
  • dimension (chaîne, obligatoire) : "ROWS" ou "COLUMNS".
  • length (entier, obligatoire) : nombre de lignes ou de colonnes à ajouter.
  • addConditionalFormatRule : ajoute une nouvelle règle de mise en forme conditionnelle. Schéma :
  • rule (objet, obligatoire) : règle de mise en forme conditionnelle ({"ranges": [GridRange], "booleanRule": {"condition": {"type": "NUMBER_GREATER_THAN_EQ"|"TEXT_CONTAINS"|..., "values": [{"userEnteredValue": string}]}, "format": CellFormat}, "gradientRule": {...}}).
  • index (entier, facultatif) : index basé sur zéro où la règle doit être insérée.
  • updateConditionalFormatRule : met à jour une règle de mise en forme conditionnelle existante. Schéma :
  • rule (objet, obligatoire) : nouvelle règle de mise en forme conditionnelle.
  • Index/ID de règle (un requis) :
    • index (entier) : index de la règle basé sur zéro.
    • sheetId (entier) : ID de la feuille si la mise à jour est effectuée par index de feuille.
  • newIndex (entier, facultatif) : nouvel index pour déplacer la règle.
  • deleteConditionalFormatRule : supprime une règle de mise en forme conditionnelle existante. Schéma :
  • index (entier, obligatoire) : index basé sur zéro de la règle à supprimer.
  • sheetId (entier, obligatoire) : ID de la feuille de la règle.
  • sortRange : trie les données d'une plage. Schéma :
  • range (objet, obligatoire) : plage de la grille à trier.
  • sortSpecs (tableau de SortSpec, obligatoire) : spécifications de tri ([{"dimensionIndex": int, "sortOrder": "ASCENDING"|"DESCENDING"}]).
  • setDataValidation : définit la validation des données pour une ou plusieurs cellules. Schéma :
  • range (objet, obligatoire) : plage de la grille.
  • rule (objet, facultatif) : règle de validation ({"condition": {"type": "ONE_OF_LIST"|"NUMBER_BETWEEN"|..., "values": [{"userEnteredValue": string}]}, "strict": bool, "showCustomUi": bool}). Si elle est omise, la validation est effacée.
  • setBasicFilter : définit le filtre de base sur une feuille. Schéma :
  • filter (objet, obligatoire) : définition du filtre de base ({"range": GridRange, "criteria": map, "sortSpecs": list}).
  • addProtectedRange : ajoute une plage protégée. Schéma :
  • protectedRange (objet, obligatoire) : définition de la plage protégée ({"range": GridRange, "description": string, "warningOnly": bool, "editors": {"users": [string]}}).
  • updateProtectedRange : met à jour une plage protégée. Schéma :
  • protectedRange (objet, obligatoire) : définition de la plage protégée avec protectedRangeId.
  • fields (chaîne, obligatoire) : masque de champ (par exemple, "description,warningOnly" ou "*").
  • deleteProtectedRange : supprime une plage protégée. Schéma :
  • protectedRangeId (entier, obligatoire) : ID de la plage protégée à supprimer.
  • autoResizeDimensions : redimensionne automatiquement une ou plusieurs dimensions en fonction du contenu des cellules. Schéma :
  • dimensions (objet, obligatoire) : plage de dimensions ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • addChart : ajoute un graphique. Schéma :
  • chart (objet, obligatoire) : définition du graphique ({"spec": {"title": string, "basicChart": {"chartType": "COLUMN"|"BAR"|"LINE"|"PIE"|"COMBO"|"SCATTER", "legendPosition": string, "axis": list, "domains": list, "series": list}}, "position": {"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}}}}).
  • updateChartSpec : met à jour les spécifications d'un graphique. Schéma :
  • chartId (entier, obligatoire) : ID du graphique.
  • spec (objet, obligatoire) : nouvelle spécification de graphique.
  • updateBanding : met à jour une plage de bandes. Schéma :
  • bandedRange (objet, obligatoire) : définition de la plage de bandes avec bandedRangeId.
  • fields (chaîne, obligatoire) : masque de champ.
  • addBanding : ajoute une nouvelle plage de bandes. Schéma :
  • bandedRange (objet, obligatoire) : définition de la plage de bandes ({"range": GridRange, "rowProperties": {"headerColorStyle": ColorStyle, "firstBandColorStyle": ColorStyle, "secondBandColorStyle": ColorStyle}}).
  • deleteBanding : supprime une plage de bandes. Schéma :
  • bandedRangeId (entier, obligatoire) : ID de la plage de bandes à supprimer.
  • createDeveloperMetadata : crée des métadonnées de développeur. Schéma :
  • developerMetadata (objet, obligatoire) : définition des métadonnées ({"metadataKey": string, "metadataValue": string, "location": {"locationType": "ROW"|"COLUMN"|"SHEET"|"SPREADSHEET", "sheetId": int}, "visibility": "DOCUMENT"|"PROJECT"}).
  • updateDeveloperMetadata : met à jour une entrée de métadonnées de développeur existante. Schéma :
  • dataFilters (tableau de DataFilter, obligatoire) : filtres permettant de sélectionner des métadonnées.
  • developerMetadata (objet, obligatoire) : valeurs de métadonnées mises à jour.
  • fields (chaîne, obligatoire) : masque de champ.
  • deleteDeveloperMetadata : supprime les métadonnées de développeur. Schéma :
  • dataFilter (objet, obligatoire) : filtre décrivant les critères des métadonnées à supprimer.
  • randomizeRange : réorganise de manière aléatoire l'ordre des lignes d'une plage. Schéma :
  • range (objet, obligatoire) : plage de la grille à randomiser.
  • addDimensionGroup : crée un groupe sur la plage spécifiée. Schéma :
  • range (objet, obligatoire) : plage de dimensions à regrouper ({"sheetId": int, "dimension": "ROWS"|"COLUMNS", "startIndex": int, "endIndex": int}).
  • deleteDimensionGroup : supprime un groupe sur la plage spécifiée. Schéma :
  • range (objet, obligatoire) : plage de dimensions du groupe à supprimer.
  • updateDimensionGroup : met à jour l'état du groupe spécifié. Schéma :
  • dimensionGroup (objet, obligatoire) : définition du groupe ({"range": DimensionRange, "depth": int, "collapsed": bool}).
  • fields (chaîne, obligatoire) : masque de champ (par exemple, "collapsed").
  • trimWhitespace : supprime les espaces blancs (tels que les espaces, les tabulations ou les nouvelles lignes) des cellules. Schéma :
  • range (objet, obligatoire) : plage de la grille dont les cellules doivent être supprimées.
  • deleteDuplicates : supprime les lignes contenant des valeurs en double dans les colonnes spécifiées d'une plage de cellules. Schéma :
  • range (objet, obligatoire) : plage de la grille dont vous souhaitez supprimer les doublons.
  • comparisonColumns (tableau de DimensionRange, facultatif) : colonnes spécifiques à analyser.
  • updateEmbeddedObjectBorder : met à jour la bordure d'un objet intégré. Schéma :
  • objectId (entier, obligatoire) : ID de l'objet intégré.
  • border (objet, obligatoire) : définition de la bordure ({"colorStyle": ColorStyle, "section": "ALL"}).
  • fields (chaîne, obligatoire) : masque de champ.
  • addSlicer : ajoute un segment. Schéma :
  • slicer (objet, obligatoire) : définition du segment ({"spec": {"dataRange": GridRange, "columnIndex": int, "title": string}, "position": {"overlayPosition": {"anchorCell": {"sheetId": int, "rowIndex": int, "columnIndex": int}}}}).
  • updateSlicerSpec : met à jour les spécifications d'un segment. Schéma :
  • slicerId (entier, obligatoire) : ID du segment.
  • spec (objet, obligatoire) : spécification du nouveau segment.
  • fields (chaîne, obligatoire) : masque de champ.
  • addDataSource : ajoute une source de données. Schéma :
  • dataSource (objet, obligatoire) : définition de la source de données ({"spec": {"bigQuery": {"projectId": string, "query": string}}}).
  • updateDataSource : met à jour une source de données. Schéma :
  • dataSource (objet, obligatoire) : définition de la source de données avec dataSourceId.
  • fields (chaîne, obligatoire) : masque de champ.
  • deleteDataSource : supprime une source de données. Schéma :
  • dataSourceId (chaîne, obligatoire) : ID de la source de données à supprimer.
  • refreshDataSource : actualise une ou plusieurs sources de données et les objets de base de données associés. Schéma :
  • dataSourceId (chaîne, facultatif) ou isAll (booléen, facultatif) ou references (objet, facultatif).
  • force (booléen, facultatif) : indique s'il faut forcer l'actualisation.
  • cancelDataSourceRefresh : annule l'actualisation d'une ou de plusieurs sources de données et des objets de base de données associés. Schéma :
  • dataSourceId (chaîne, facultatif) ou isAll (booléen, facultatif) ou references (objet, facultatif).
  • addTable : ajoute une table. Schéma :
  • table (objet, obligatoire) : définition de la table ({"range": GridRange, "name": string, "hasHeaderRow": bool, "hasTotalsRow": bool}).
  • updateTable : met à jour une table. Schéma :
  • table (objet, obligatoire) : définition de la table avec tableId.
  • fields (chaîne, obligatoire) : masque de champ.
  • deleteTable : requête de suppression d'une table. Schéma :
  • tableId (chaîne, obligatoire) : ID de la table à supprimer.
  • insertComment : insère un commentaire dans la feuille de calcul. Schéma :
  • content (chaîne, obligatoire) : contenu du commentaire en texte brut.
  • coordinate (objet, obligatoire) : coordonnées de la grille dans la feuille pour ancrer le commentaire :
    • sheetId (entier, obligatoire) : ID de la feuille.
    • rowIndex (entier, obligatoire) : index de ligne basé sur zéro.
    • columnIndex (entier, obligatoire) : index de colonne basé sur zéro.
  • assigneeEmailAddress (chaîne, facultatif) : adresse e-mail de la personne responsable du commentaire.
  • addCommentReply : ajoute une réponse à un fil de commentaires existant. Également utilisé pour résoudre ou rouvrir un fil de discussion. Schéma :
  • commentId (chaîne, obligatoire) : ID du fil de commentaires.
  • post (objet, obligatoire) :
    • content (chaîne, obligatoire, sauf si commentAction est défini sur RESOLVE ou REOPEN) : contenu en texte brut de la réponse.
    • commentAction (chaîne, facultatif) : action effectuée avec cette réponse ("RESOLVE" ou "REOPEN").
    • assigneeEmail (chaîne, facultatif) : adresse e-mail à laquelle attribuer le fil de discussion.
  • updateCommentPost : met à jour le contenu d'un commentaire dans un fil de commentaires. Schéma :
  • commentId (chaîne, obligatoire) : ID du fil de commentaires.
  • postId (chaîne, obligatoire) : ID du commentaire à mettre à jour.
  • content (chaîne, obligatoire) : contenu mis à jour du commentaire.
  • deleteComment : supprime un fil de commentaires. Schéma :
  • commentId (chaîne, obligatoire) : ID du fil de commentaires à supprimer.
  • deleteCommentReply : supprime une réponse. Schéma :
  • commentId (chaîne, obligatoire) : ID du fil de commentaires.
  • postId (chaîne, obligatoire) : ID de la réponse à supprimer.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP update_spreadsheet.

Requête curl 
curl --location 'https://sheetsmcp.googleapis.com/mcp/v1' \
--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_spreadsheet",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

UpdateContentRequest

Représentation JSON 
{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Champs
spreadsheetId

string

Obligatoire. ID de la feuille de calcul à mettre à jour.
requests[]

object (Struct format)

Obligatoire. Liste des mises à jour à appliquer à la feuille de calcul. Chaque requête doit être un objet Request spreadsheets.batchUpdate valide, utilisant le schéma documenté sur la page https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request. Les requêtes seront appliquées dans l'ordre où elles sont spécifiées. Si l'une des requêtes n'est pas valide, aucune requête ne sera appliquée.
writeControl

object (WriteControl)

Facultatif. Permet de contrôler l'exécution des requêtes d'écriture.

Struct

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

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

Mappage non ordonné de valeurs saisies 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 en 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 de nombre.
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 saisies de manière dynamique.

WriteControl

Représentation JSON 
{

  "requiredRevisionId": string
}
Champs
Champ d'union control. Détermine la révision de la feuille de calcul dans laquelle écrire et le comportement de la requête si cette révision n'est pas la révision actuelle de la feuille de calcul. control ne peut être qu'un des éléments suivants :
requiredRevisionId

string

ID de révision de la feuille de calcul à laquelle la requête d'écriture sera appliquée. S'il ne s'agit pas de la dernière révision du document, la requête ne sera pas traitée et renverra une erreur 400 (requête incorrecte).

Lorsqu'un ID de révision requis est renvoyé dans une réponse, il indique l'ID de révision de la feuille de calcul après l'application de la requête.

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 pour l'union de types 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 un 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

UpdateContentResponse

Représentation JSON 
{
  "content": {
    object
  }
}
Champs
content

object (Struct format)

La réponse spreadsheets.batchUpdate, au format JSON de l'API Sheets, plus un champ status.

Struct

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

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

Mappage non ordonné de valeurs saisies 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 en 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 de nombre.
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 saisies 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 pour l'union de types 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 un 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

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients considèrent ces indications comme non fiables, mais elles peuvent être utilisées pour décider quand envoyer une invite de confirmation à un utilisateur.

En plus de la chaîne de titre, les indices booléens suivants sont définis comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indice "Destructeur" : ❌ | Indice "Idempotent" : ❌ | Indice "Lecture seule" : ❌ | Indice "Monde ouvert" : ✅

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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