---
title: Google Forms
description: Lire les réponses d'un formulaire Google
---

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

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

{/* MANUAL-CONTENT-START:intro */}
[Google Forms](https://forms.google.com) est l'outil de sondage et de formulaire en ligne de Google qui permet aux utilisateurs de créer des formulaires, de collecter des réponses et d'analyser les résultats. En tant que partie intégrante de la suite de productivité de Google, Google Forms facilite la collecte d'informations, de retours et de données des utilisateurs.

Découvrez comment intégrer l'outil Google Forms dans Sim pour lire et traiter automatiquement les réponses aux formulaires dans vos flux de travail. Ce tutoriel vous guide à travers la connexion à Google Forms, la récupération des réponses et l'utilisation des données collectées pour alimenter l'automatisation. Parfait pour synchroniser les résultats de sondages, les inscriptions ou les retours avec vos agents en temps réel.

Avec Google Forms, vous pouvez :

- **Créer des sondages et des formulaires** : Concevoir des formulaires personnalisés pour les retours, les inscriptions, les quiz et plus encore
- **Collecter des réponses automatiquement** : Recueillir des données des utilisateurs en temps réel
- **Analyser les résultats** : Consulter les réponses dans Google Forms ou les exporter vers Google Sheets pour une analyse plus approfondie
- **Collaborer facilement** : Partager des formulaires et travailler avec d'autres pour créer et réviser des questions
- **Intégrer avec d'autres services Google** : Se connecter à Google Sheets, Drive et plus encore

Dans Sim, l'intégration de Google Forms permet à vos agents d'accéder par programmation aux réponses des formulaires. Cela permet des scénarios d'automatisation puissants tels que le traitement des données d'enquête, le déclenchement de flux de travail basés sur de nouvelles soumissions et la synchronisation des résultats de formulaires avec d'autres outils. Vos agents peuvent récupérer toutes les réponses d'un formulaire, obtenir une réponse spécifique et utiliser les données pour piloter une automatisation intelligente. En connectant Sim avec Google Forms, vous pouvez automatiser la collecte de données, simplifier le traitement des retours et intégrer les réponses aux formulaires dans les capacités de votre agent.
{/* MANUAL-CONTENT-END */}

## Instructions d'utilisation

Intégrez Google Forms dans votre flux de travail. Fournissez un ID de formulaire pour lister les réponses, ou spécifiez un ID de réponse pour récupérer une seule réponse. Nécessite OAuth.

## Outils

### `google_forms_get_responses`

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| formId | string | Oui | L'ID du formulaire Google |
| responseId | string | Non | Si fourni, renvoie cette réponse spécifique |
| pageSize | number | Non | Nombre maximal de réponses à renvoyer (le service peut en renvoyer moins). Par défaut 5000 |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `data` | json | Réponse ou liste de réponses |

## Remarques

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

Récupérer la structure d'un formulaire incluant ses éléments, paramètres et métadonnées

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ------------ | ----------- |
| `formId` | string | Oui | ID du formulaire Google Forms à récupérer |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `formId` | string | L'ID du formulaire |
| `title` | string | Le titre du formulaire visible par les répondants |
| `description` | string | La description du formulaire |
| `documentTitle` | string | Le titre du document visible dans Drive |
| `responderUri` | string | L'URI à partager avec les répondants |
| `linkedSheetId` | string | L'ID de la feuille Google Sheets liée |
| `revisionId` | string | L'ID de révision du formulaire |
| `items` | array | Les éléments du formulaire (questions, sections, etc.) |
|   ↳ `itemId` | string | ID de l'élément |
|   ↳ `title` | string | Titre de l'élément |
|   ↳ `description` | string | Description de l'élément |
| `settings` | json | Paramètres du formulaire |
| `publishSettings` | json | Paramètres de publication du formulaire |

### `google_forms_create_form`

Créer un nouveau formulaire Google avec un titre

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ------------ | ----------- |
| `title` | string | Oui | Le titre du formulaire visible par les répondants |
| `documentTitle` | string | Non | Le titre du document visible dans Drive (par défaut le titre du formulaire) |
| `unpublished` | boolean | Non | Si vrai, créer un formulaire non publié qui n'accepte pas de réponses |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `formId` | string | L'ID du formulaire créé |
| `title` | string | Le titre du formulaire |
| `documentTitle` | string | Le titre du document dans Drive |
| `responderUri` | string | L'URI à partager avec les répondants |
| `revisionId` | string | L'ID de révision du formulaire |

### `google_forms_batch_update`

Appliquer plusieurs mises à jour à un formulaire (ajouter des éléments, mettre à jour les informations, modifier les paramètres, etc.)

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `formId` | string | Oui | ID du formulaire Google Forms |
| `requests` | json | Oui | Tableau de requêtes de mise à jour (updateFormInfo, updateSettings, createItem, updateItem, moveItem, deleteItem) |
| `includeFormInResponse` | boolean | Non | Indique s'il faut retourner le formulaire mis à jour dans la réponse |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `replies` | array | Les réponses de chaque requête de mise à jour |
| `writeControl` | object | Informations de contrôle d'écriture avec les ID de révision |
|   ↳ `requiredRevisionId` | string | ID de révision requis pour la détection de conflits |
|   ↳ `targetRevisionId` | string | ID de révision cible |
| `form` | object | Le formulaire mis à jour (si includeFormInResponse était true) |
|   ↳ `formId` | string | L'ID du formulaire |
|   ↳ `info` | object | Informations du formulaire contenant le titre et la description |
|     ↳ `title` | string | Le titre du formulaire visible par les répondants |
|     ↳ `description` | string | La description du formulaire |
|     ↳ `documentTitle` | string | Le titre du document visible dans Drive |
|   ↳ `settings` | object | Paramètres du formulaire |
|     ↳ `quizSettings` | object | Paramètres du quiz |
|       ↳ `isQuiz` | boolean | Indique si le formulaire est un quiz |
|     ↳ `emailCollectionType` | string | Type de collecte d'e-mail |
|   ↳ `revisionId` | string | L'ID de révision du formulaire |
|   ↳ `responderUri` | string | L'URI à partager avec les répondants |
|   ↳ `linkedSheetId` | string | L'ID de la feuille Google liée |
|   ↳ `publishSettings` | object | Paramètres de publication du formulaire |
|     ↳ `publishState` | object | État de publication actuel |
|       ↳ `isPublished` | boolean | Indique si le formulaire est publié |
|       ↳ `isAcceptingResponses` | boolean | Indique si le formulaire accepte des réponses |

### `google_forms_set_publish_settings`

Mettre à jour les paramètres de publication d'un formulaire (publier/dépublier, accepter les réponses)

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `formId` | string | Oui | ID du formulaire Google Forms |
| `isPublished` | boolean | Oui | Indique si le formulaire est publié et visible par les autres |
| `isAcceptingResponses` | boolean | Non | Indique si le formulaire accepte les réponses \(forcé à false si isPublished est false\) |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `formId` | string | L'ID du formulaire |
| `publishSettings` | json | Les paramètres de publication mis à jour |
|   ↳ `publishState` | object | L'état de publication |
|     ↳ `isPublished` | boolean | Indique si le formulaire est publié |
|     ↳ `isAcceptingResponses` | boolean | Indique si le formulaire accepte les réponses |

### `google_forms_create_watch`

Créer une surveillance de notification pour les modifications du formulaire (modifications du schéma ou nouvelles réponses)

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `formId` | string | Oui | ID du formulaire Google Forms à surveiller |
| `eventType` | string | Oui | Type d'événement à surveiller : SCHEMA \(modifications du formulaire\) ou RESPONSES \(nouvelles soumissions\) |
| `topicName` | string | Oui | Le nom du sujet Cloud Pub/Sub \(format : projects/\{project\}/topics/\{topic\}\) |
| `watchId` | string | Non | ID de surveillance personnalisé \(4-63 caractères, lettres minuscules, chiffres, traits d'union\) |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `id` | string | L'ID de la surveillance |
| `eventType` | string | Le type d'événement surveillé |
| `topicName` | string | Le sujet Cloud Pub/Sub |
| `createTime` | string | Date de création de la surveillance |
| `expireTime` | string | Date d'expiration de la surveillance (7 jours après la création) |
| `state` | string | L'état de la surveillance (ACTIVE, SUSPENDED) |

### `google_forms_list_watches`

Lister toutes les surveillances de notification pour un formulaire

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `formId` | string | Oui | ID du formulaire Google Forms |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `watches` | array | Liste des surveillances pour le formulaire |
|   ↳ `id` | string | ID de la surveillance |
|   ↳ `eventType` | string | Type d'événement (SCHEMA ou RESPONSES) |
|   ↳ `createTime` | string | Date de création de la surveillance |
|   ↳ `expireTime` | string | Date d'expiration de la surveillance |
|   ↳ `state` | string | État de la surveillance |

### `google_forms_delete_watch`

Supprimer une surveillance de notification d'un formulaire

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `formId` | string | Oui | ID du formulaire Google Forms |
| `watchId` | string | Oui | ID de la surveillance à supprimer |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `deleted` | boolean | Indique si la surveillance a été supprimée avec succès |

### `google_forms_renew_watch`

Renouveler une surveillance de notification pour 7 jours supplémentaires

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ----------- | ----------- |
| `formId` | string | Oui | ID du formulaire Google Forms |
| `watchId` | string | Oui | ID de la surveillance à renouveler |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `id` | string | L'ID de la surveillance |
| `eventType` | string | Le type d'événement surveillé |
| `expireTime` | string | La nouvelle date d'expiration |
| `state` | string | L'état de la surveillance |
