$npx -y skills add googleworkspace/cli --skill gws-formsRead and write Google Forms.
| 1 | # forms (v1) |
| 2 | |
| 3 | > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. |
| 4 | |
| 5 | ```bash |
| 6 | gws forms <resource> <method> [flags] |
| 7 | ``` |
| 8 | |
| 9 | ## API Resources |
| 10 | |
| 11 | ### forms |
| 12 | |
| 13 | - `batchUpdate` — Change the form with a batch of updates. |
| 14 | - `create` — 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. |
| 15 | - `get` — Get a form. |
| 16 | - `setPublishSettings` — Updates the publish settings of a form. Legacy forms aren't supported because they don't have the `publish_settings` field. |
| 17 | - `responses` — Operations on the 'responses' resource |
| 18 | - `watches` — Operations on the 'watches' resource |
| 19 | |
| 20 | ## Discovering Commands |
| 21 | |
| 22 | Before calling any API method, inspect it: |
| 23 | |
| 24 | ```bash |
| 25 | # Browse resources and methods |
| 26 | gws forms --help |
| 27 | |
| 28 | # Inspect a method's required params, types, and defaults |
| 29 | gws schema forms.<resource>.<method> |
| 30 | ``` |
| 31 | |
| 32 | Use `gws schema` output to build your `--params` and `--json` flags. |