Pour permettre aux créateurs de formulaires de contrôler plus précisément qui peut y répondre, nous lançons des contrôles précis pour les personnes interrogées. Les formulaires créés avec l'API après le 31 janvier 2026 seront par défaut publiés. Pour en savoir plus, consultez Modifications des API dans Google Forms.
Créez un formulaire en utilisant le titre indiqué dans le message du formulaire fourni dans la requête.
Important:Seuls les champs form.info.title et form.info.document_title sont copiés dans le nouveau formulaire. Tous les autres champs, y compris la description, les éléments et les paramètres du formulaire, ne sont pas autorisés. Pour créer un formulaire et y ajouter des éléments, vous devez d'abord appeler forms.create pour créer un formulaire vide avec un titre et un titre de document (facultatif), puis appeler forms.update pour ajouter les éléments.
Facultatif. Indique si le formulaire n'est pas publié. Si la valeur est true, le formulaire n'accepte pas de réponses. Si la valeur est false ou non définie, le formulaire est publié et accepte les réponses.
Corps de la requête
Le corps de la requête contient une instance de Form.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Form.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/25 (UTC)."],[],["This describes how to create a new form via an HTTP POST request to `https://forms.googleapis.com/v1/forms`. The request body should contain a `Form` instance, specifying the title and document title, and other fields are ignored. A successful response returns the newly created `Form`. The process requires authorization via one of the listed OAuth scopes. Adding items and further details must use the `forms.update` method after initial form creation using `forms.create`.\n"],null,["# Method: forms.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreate a new form using the title given in the provided form message in the request.\n\n\u003cbr /\u003e\n\n**Important:** Only the [form.info.title](/workspace/forms/api/reference/rest/v1/forms#Info.FIELDS.title) and [form.info.document_title](/workspace/forms/api/reference/rest/v1/forms#Info.FIELDS.document_title) fields are copied to the new form. All other fields including the form description, items and settings are disallowed. To create a new form and add items, you must first call [forms.create](/workspace/forms/api/reference/rest/v1/forms/create#google.apps.forms.v1.FormsService.CreateForm) to create an empty form with a title and (optional) document title, and then call [forms.update](/workspace/forms/api/reference/rest/v1/forms/batchUpdate#google.apps.forms.v1.FormsService.BatchUpdateForm) to add the items.\n\n### HTTP request\n\n`POST https://forms.googleapis.com/v1/forms`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unpublished` | `boolean` Optional. Whether the form is unpublished. If set to `true`, the form doesn't accept responses. If set to `false` or unset, the form is published and accepts responses. |\n\n### Request body\n\nThe request body contains an instance of [Form](/workspace/forms/api/reference/rest/v1/forms#Form).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Form](/workspace/forms/api/reference/rest/v1/forms#Form).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/forms.body`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
