Mettre à jour un formulaire avec l'API Google Forms
Modifie un formulaire : crée, change, déplace et supprime des questions, blocs de texte et sections, et change le titre, la description et la collecte d'e-mails. Les modifications s'appliquent dans l'ordre et en tout ou rien. Les réponses de createItem apportent le nouvel itemId et questionId.
- Identifiant
- google_forms_update_form
L'appel
POST https://connect.reportei.com/api/tools/google_forms_update_form/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"formId": "<formId>",
"requests": []
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| formId | string | Oui | Form id from Create form, or from the editing URL of the form, between /d/ and /edit. The link for respondents, with /d/e/, carries another id. |
| requests | array | Oui | The edits. Each item has exactly one of the keys below. Each edit sees the form as the previous ones left it, so the positions shift after a create, a delete or a move. |
| includeFormInResponse | boolean | Non | Returns the whole form after the edits. |
| writeControl | object | Non | Guards the edits against changes made to the form after Get form. Use one of the two fields. |
Connexions possibles
Votre client connecte son compte Google Forms une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/google_forms, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/google_forms_update_form. Il devient la définition de tool de votre agent sans conversion.
Autres tools Google Forms
- Créer un formulairePOSTCrée un formulaire vide avec un titre et renvoie son formId et responderUri, le lien pour les répondants. Ajoutez les questions avec Update form. Depuis juillet 2026, un formulaire créé par l'API démarre non publié et n'accepte pas de réponses tant que Update publish settings ne l'a pas publié.
- Obtenir un formulaireGETRenvoie un formulaire : info, settings, publishSettings, responderUri (le lien pour les répondants), revisionId et les éléments dans l'ordre, chacun avec son itemId et, pour une question, son questionId. Les réponses de List responses sont indexées par questionId.
- Mettre à jour les réglages de publicationPOSTPublie, ferme ou dépublie un formulaire. isPublished et isAcceptingResponses tous deux true l'ouvrent aux réponses, isPublished true avec isAcceptingResponses false le ferme, et les deux false le dépublient. Qui peut répondre suit le partage du formulaire dans Google Drive. Les formulaires hérités, dont Get form n'a pas publishSettings, ne sont pas pris en charge.
- Lister les réponsesGETListe les réponses d'un formulaire, chacune avec responseId, createTime, lastSubmittedTime, respondentEmail quand le formulaire le collecte et answers indexées par questionId : Get form indique quelle question correspond à chaque questionId. Passez nextPageToken comme pageToken pour lire la page suivante.
- Obtenir une réponseGETRenvoie une réponse d'un formulaire, avec les réponses indexées par questionId.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
