---
title: Google Sheets
description: Lire, écrire et mettre à jour des données
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="google_sheets"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Google Sheets](https://sheets.google.com) est une application de tableur puissante basée sur le cloud qui permet aux utilisateurs de créer, modifier et collaborer sur des feuilles de calcul en temps réel. En tant que partie intégrante de la suite bureautique de Google, Google Sheets offre une plateforme polyvalente pour l'organisation, l'analyse et la visualisation des données avec de solides capacités de formatage, de formules et de partage.

Découvrez comment intégrer l'outil « Lecture » de Google Sheets dans Sim pour récupérer facilement les données de vos feuilles de calcul et les intégrer dans vos flux de travail. Ce tutoriel vous guide à travers la connexion à Google Sheets, la configuration des lectures de données et l'utilisation de ces informations pour automatiser les processus en temps réel. Parfait pour synchroniser des données en direct avec vos agents.

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/xxP7MZRuq_0"
  title="Utiliser l'outil de lecture Google Sheets dans Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Découvrez comment utiliser l'outil « Écriture » de Google Sheets dans Sim pour envoyer automatiquement des données de vos flux de travail vers vos feuilles Google Sheets. Ce tutoriel couvre la configuration de l'intégration, la configuration des opérations d'écriture et la mise à jour transparente de vos feuilles lors de l'exécution des flux de travail. Parfait pour maintenir des enregistrements en temps réel sans saisie manuelle.

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/cO86qTj7qeY"
  title="Utiliser l'outil d'écriture Google Sheets dans Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Explorez comment tirer parti de l'outil « Mise à jour » de Google Sheets dans Sim pour modifier des entrées existantes dans vos feuilles de calcul en fonction de l'exécution du flux de travail. Ce tutoriel démontre la configuration de la logique de mise à jour, le mappage des champs de données et la synchronisation instantanée des modifications. Parfait pour maintenir vos données actuelles et cohérentes.

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/95by2fL9yn4"
  title="Utiliser l'outil de mise à jour Google Sheets dans Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Découvrez comment utiliser l'outil "Ajouter" de Google Sheets dans Sim pour ajouter sans effort de nouvelles lignes de données à vos feuilles de calcul pendant l'exécution du flux de travail. Ce tutoriel vous guide à travers la configuration de l'intégration, la mise en place des actions d'ajout et l'assurance d'une croissance fluide des données. Parfait pour développer vos enregistrements sans effort manuel !

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/8DgNvLBCsAo"
  title="Utiliser l'outil d'ajout Google Sheets dans Sim"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Avec Google Sheets, vous pouvez :

- **Créer et modifier des feuilles de calcul** : développer des documents basés sur des données avec des options complètes de formatage et de calcul
- **Collaborer en temps réel** : travailler simultanément avec plusieurs utilisateurs sur la même feuille de calcul
- **Analyser des données** : utiliser des formules, des fonctions et des tableaux croisés dynamiques pour traiter et comprendre vos données
- **Visualiser les informations** : créer des graphiques, des diagrammes et du formatage conditionnel pour représenter visuellement les données
- **Accéder partout** : utiliser Google Sheets sur différents appareils avec synchronisation automatique dans le cloud
- **Travailler hors ligne** : continuer à travailler sans connexion internet avec synchronisation des modifications lors de la reconnexion
- **Intégrer avec d'autres services** : se connecter à Google Drive, Forms et applications tierces

Dans Sim, l'intégration de Google Sheets permet à vos agents d'interagir directement avec les données des feuilles de calcul de manière programmatique. Cela permet des scénarios d'automatisation puissants tels que l'extraction de données, l'analyse, la création de rapports et la gestion. Vos agents peuvent lire des feuilles de calcul existantes pour extraire des informations, écrire dans des feuilles de calcul pour mettre à jour des données et créer de nouvelles feuilles de calcul à partir de zéro. Cette intégration comble le fossé entre vos flux de travail IA et la gestion des données, permettant une interaction transparente avec des données structurées. En connectant Sim à Google Sheets, vous pouvez automatiser les flux de travail de données, générer des rapports, extraire des informations à partir des données et maintenir des informations à jour - le tout grâce à vos agents intelligents. L'intégration prend en charge divers formats de données et spécifications de plages, ce qui la rend suffisamment flexible pour gérer divers besoins de gestion de données tout en maintenant la nature collaborative et accessible de Google Sheets.
{/* MANUAL-CONTENT-END */}

## Instructions d'utilisation

Intégrez Google Sheets dans le flux de travail. Peut lire, écrire, ajouter et mettre à jour des données. Nécessite OAuth.

## Outils

### `google_sheets_read`

Lire des données d'une feuille de calcul Google Sheets

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `spreadsheetId` | chaîne | Oui | L'identifiant de la feuille de calcul \(trouvé dans l'URL : docs.google.com/spreadsheets/d/\{SPREADSHEET_ID\}/edit\). |
| `range` | chaîne | Non | La plage en notation A1 à lire \(par exemple "Sheet1!A1:D10", "A1:B5"\). Par défaut, première feuille A1:Z1000 si non spécifié. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `data` | json | Données de la feuille incluant la plage et les valeurs des cellules |
| `metadata` | json | Métadonnées de la feuille de calcul incluant l'ID et l'URL |

### `google_sheets_write`

Écrire des données dans une feuille de calcul Google Sheets

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `spreadsheetId` | chaîne | Oui | L'identifiant de la feuille de calcul |
| `range` | chaîne | Non | La plage en notation A1 où écrire \(par exemple "Sheet1!A1:D10", "A1:B5"\) |
| `values` | tableau | Oui | Les données à écrire sous forme de tableau 2D \(par exemple \[\["Nom", "Âge"\], \["Alice", 30\], \["Bob", 25\]\]\) ou tableau d'objets. |
| `valueInputOption` | chaîne | Non | Le format des données à écrire |
| `includeValuesInResponse` | booléen | Non | Indique si les valeurs écrites doivent être incluses dans la réponse |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `updatedRange` | string | Plage de cellules qui ont été mises à jour |
| `updatedRows` | number | Nombre de lignes mises à jour |
| `updatedColumns` | number | Nombre de colonnes mises à jour |
| `updatedCells` | number | Nombre de cellules mises à jour |
| `metadata` | json | Métadonnées de la feuille de calcul, y compris l'ID et l'URL |

### `google_sheets_update`

Mettre à jour des données dans une feuille de calcul Google Sheets

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `spreadsheetId` | chaîne | Oui | L'identifiant de la feuille de calcul à mettre à jour |
| `range` | chaîne | Non | La plage en notation A1 à mettre à jour \(par exemple "Sheet1!A1:D10", "A1:B5"\) |
| `values` | tableau | Oui | Les données à mettre à jour sous forme de tableau 2D \(par exemple \[\["Nom", "Âge"\], \["Alice", 30\]\]\) ou tableau d'objets. |
| `valueInputOption` | chaîne | Non | Le format des données à mettre à jour |
| `includeValuesInResponse` | booléen | Non | Indique si les valeurs mises à jour doivent être incluses dans la réponse |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `updatedRange` | string | Plage de cellules qui ont été mises à jour |
| `updatedRows` | number | Nombre de lignes mises à jour |
| `updatedColumns` | number | Nombre de colonnes mises à jour |
| `updatedCells` | number | Nombre de cellules mises à jour |
| `metadata` | json | Métadonnées de la feuille de calcul, y compris l'ID et l'URL |

### `google_sheets_append`

Ajouter des données à la fin d'une feuille de calcul Google Sheets

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `spreadsheetId` | chaîne | Oui | L'identifiant de la feuille de calcul à laquelle ajouter des données |
| `range` | chaîne | Non | La plage de notation A1 après laquelle ajouter des données \(ex. "Feuille1", "Feuille1!A:D"\) |
| `values` | tableau | Oui | Les données à ajouter sous forme de tableau 2D \(ex. \[\["Alice", 30\], \["Bob", 25\]\]\) ou tableau d'objets. |
| `valueInputOption` | chaîne | Non | Le format des données à ajouter |
| `insertDataOption` | chaîne | Non | Comment insérer les données \(OVERWRITE ou INSERT_ROWS\) |
| `includeValuesInResponse` | booléen | Non | Indique s'il faut inclure les valeurs ajoutées dans la réponse |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `tableRange` | chaîne | Plage du tableau où les données ont été ajoutées |
| `updatedRange` | chaîne | Plage de cellules qui ont été mises à jour |
| `updatedRows` | nombre | Nombre de lignes mises à jour |
| `updatedColumns` | nombre | Nombre de colonnes mises à jour |
| `updatedCells` | nombre | Nombre de cellules mises à jour |
| `metadata` | json | Métadonnées de la feuille de calcul, y compris l'ID et l'URL |

## Remarques

- Catégorie : `tools`
- Type : `google_sheets`

| Paramètre | Type | Requis | Description |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Oui | ID de la feuille de calcul Google Sheets |
| `includeGridData` | boolean | Non | Indique s'il faut inclure les données de grille \(valeurs des cellules\). Par défaut false. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | L'ID de la feuille de calcul |
| `title` | string | Le titre de la feuille de calcul |
| `locale` | string | La locale de la feuille de calcul |
| `timeZone` | string | Le fuseau horaire de la feuille de calcul |
| `spreadsheetUrl` | string | URL vers la feuille de calcul |
| `sheets` | array | Liste des feuilles dans la feuille de calcul |
|   ↳ `sheetId` | number | L'ID de la feuille |
|   ↳ `title` | string | Le titre/nom de la feuille |
|   ↳ `index` | number | L'index de la feuille \(position\) |
|   ↳ `rowCount` | number | Nombre de lignes dans la feuille |
|   ↳ `columnCount` | number | Nombre de colonnes dans la feuille |
|   ↳ `hidden` | boolean | Indique si la feuille est masquée |

### `google_sheets_create_spreadsheet`

Créer une nouvelle feuille de calcul Google Sheets

#### Entrée

| Paramètre | Type | Requis | Description |
| --------- | ---- | -------- | ----------- |
| `title` | string | Oui | Le titre de la nouvelle feuille de calcul |
| `sheetTitles` | json | Non | Tableau de noms de feuilles à créer \(par exemple, \["Feuille1", "Données", "Résumé"\]\). Par défaut une seule "Feuille1". |
| `locale` | string | Non | La locale de la feuille de calcul \(par exemple, "fr_FR"\) |
| `timeZone` | string | Non | Le fuseau horaire de la feuille de calcul \(par exemple, "Europe/Paris"\) |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | L'ID de la feuille de calcul créée |
| `title` | string | Le titre de la feuille de calcul créée |
| `spreadsheetUrl` | string | URL vers la feuille de calcul créée |
| `sheets` | array | Liste des feuilles créées dans la feuille de calcul |
|   ↳ `sheetId` | number | L'ID de la feuille |
|   ↳ `title` | string | Le titre/nom de la feuille |
|   ↳ `index` | number | L'index de la feuille (position) |

### `google_sheets_batch_get`

Lire plusieurs plages d'une feuille de calcul Google Sheets en une seule requête

#### Entrée

| Paramètre | Type | Requis | Description |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Oui | ID de la feuille de calcul Google Sheets |
| `ranges` | json | Oui | Tableau de plages à lire (par ex., ["Feuille1!A1:D10", "Feuille2!A1:B5"]). Chaque plage doit inclure le nom de la feuille. |
| `majorDimension` | string | Non | La dimension principale des valeurs : "ROWS" (par défaut) ou "COLUMNS" |
| `valueRenderOption` | string | Non | Comment les valeurs doivent être rendues : "FORMATTED_VALUE" (par défaut), "UNFORMATTED_VALUE" ou "FORMULA" |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | L'ID de la feuille de calcul |
| `valueRanges` | array | Tableau de plages de valeurs lues depuis la feuille de calcul |
|   ↳ `range` | string | La plage qui a été lue |
|   ↳ `majorDimension` | string | Dimension principale (ROWS ou COLUMNS) |
|   ↳ `values` | array | Les valeurs des cellules sous forme de tableau 2D |
| `metadata` | json | Métadonnées de la feuille de calcul, y compris l'ID et l'URL |
|   ↳ `spreadsheetId` | string | ID de la feuille de calcul Google Sheets |
|   ↳ `spreadsheetUrl` | string | URL de la feuille de calcul |

### `google_sheets_batch_update`

Mettre à jour plusieurs plages dans une feuille de calcul Google Sheets en une seule requête

#### Entrée

| Paramètre | Type | Requis | Description |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | Oui | ID de la feuille de calcul Google Sheets |
| `data` | json | Oui | Tableau de plages de valeurs à mettre à jour. Chaque élément doit avoir "range" (par ex., "Sheet1!A1:D10") et "values" (tableau 2D). |
| `valueInputOption` | string | Non | Comment les données d'entrée doivent être interprétées : "RAW" ou "USER_ENTERED" (par défaut). USER_ENTERED analyse les formules. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | L'ID de la feuille de calcul |
| `totalUpdatedRows` | number | Nombre total de lignes mises à jour |
| `totalUpdatedColumns` | number | Nombre total de colonnes mises à jour |
| `totalUpdatedCells` | number | Nombre total de cellules mises à jour |
| `totalUpdatedSheets` | number | Nombre total de feuilles mises à jour |
| `responses` | array | Tableau de réponses de mise à jour pour chaque plage |
|   ↳ `spreadsheetId` | string | L'ID de la feuille de calcul |
|   ↳ `updatedRange` | string | La plage qui a été mise à jour |
|   ↳ `updatedRows` | number | Nombre de lignes mises à jour dans cette plage |
|   ↳ `updatedColumns` | number | Nombre de colonnes mises à jour dans cette plage |
|   ↳ `updatedCells` | number | Nombre de cellules mises à jour dans cette plage |
| `metadata` | json | Métadonnées de la feuille de calcul, y compris l'ID et l'URL |
|   ↳ `spreadsheetId` | string | ID de la feuille de calcul Google Sheets |
|   ↳ `spreadsheetUrl` | string | URL de la feuille de calcul |

### `google_sheets_batch_clear`

Effacer plusieurs plages dans une feuille de calcul Google Sheets en une seule requête

#### Entrée

| Paramètre | Type | Requis | Description |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | chaîne | Oui | ID de la feuille de calcul Google Sheets |
| `ranges` | json | Oui | Tableau de plages à effacer \(par exemple, \["Feuille1!A1:D10", "Feuille2!A1:B5"\]\). Chaque plage doit inclure le nom de la feuille. |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `spreadsheetId` | chaîne | L'ID de la feuille de calcul |
| `clearedRanges` | tableau | Tableau des plages qui ont été effacées |
| `metadata` | json | Métadonnées de la feuille de calcul, y compris l'ID et l'URL |
|   ↳ `spreadsheetId` | chaîne | ID de la feuille de calcul Google Sheets |
|   ↳ `spreadsheetUrl` | chaîne | URL de la feuille de calcul |

### `google_sheets_copy_sheet`

Copier une feuille d'une feuille de calcul vers une autre

#### Entrée

| Paramètre | Type | Requis | Description |
| --------- | ---- | -------- | ----------- |
| `sourceSpreadsheetId` | chaîne | Oui | ID de la feuille de calcul Google Sheets source |
| `sheetId` | nombre | Oui | L'ID de la feuille à copier \(ID numérique, pas le nom de la feuille\). Utilisez Obtenir la feuille de calcul pour trouver les ID de feuille. |
| `destinationSpreadsheetId` | chaîne | Oui | L'ID de la feuille de calcul de destination où la feuille sera copiée |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `sheetId` | nombre | L'ID de la feuille nouvellement créée dans la destination |
| `title` | chaîne | Le titre de la feuille copiée |
| `index` | nombre | L'index \(position\) de la feuille copiée |
| `sheetType` | chaîne | Le type de la feuille \(GRID, CHART, etc.\) |
| `destinationSpreadsheetId` | chaîne | L'ID de la feuille de calcul de destination |
| `destinationSpreadsheetUrl` | chaîne | URL vers la feuille de calcul de destination |
