Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13106450.1 KB
forms

Create a new form using the title given in the provided form message in the request. Important: Only the form.info.title and form.info.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 to create an empty form with a title and (optional) document title, and then call forms.update to add the items.

post/v1/forms

Query parameters

unpublishedboolean

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.

Request body

linkedSheetIdstring

Output only. The ID of the linked Google Sheet which is accumulating responses from this Form (if such a Sheet exists).

formIdstring

Output only. The form ID.

revisionIdstring

Output only. The revision ID of the form. Used in the WriteControl in update requests to identify the revision on which the changes are based. The format of the revision ID may change over time, so it should be treated opaquely. A returned revision ID is only guaranteed to be valid for 24 hours after it has been returned and cannot be shared across users. If the revision ID is unchanged between calls, then the form content has not changed. Conversely, a changed ID (for the same form and user) usually means the form content has been updated; however, a changed ID can also be due to internal factors such as ID format changes. Form content excludes form metadata, including: * sharing settings (who has access to the form) * publish_settings (if the form supports publishing and if it is published)

responderUristring

Output only. The form URI to share with responders. This opens a page that allows the user to submit responses but not edit the questions. For forms that have publish_settings value set, this is the published form URI.

Response

Successful response