---
name: gog-forms
description: "Google Forms via the gog CLI: read a form's structure, list and fetch responses, create/update forms, add/move/delete questions, publish, and manage response watches. Use for Forms automation with JSON output."
---

# gog forms

Forms reads and writes with parseable output. Pick the account on every call
with `--account <email>` (or set `GOG_ACCOUNT`).

## Reads

```bash
gog --account you@example.com forms get <formId> --json --wrap-untrusted
gog --account you@example.com forms responses list <formId> --json --wrap-untrusted
gog --account you@example.com forms responses get <formId> <responseId> --json --wrap-untrusted
```

## Writes

```bash
gog --account you@example.com forms create --title "Temp - survey" --json
gog --account you@example.com forms update <formId> --title "..."
gog --account you@example.com forms add-question <formId> --type TEXT --title "Name"
gog --account you@example.com forms move-question <formId> --from 2 --to 0
gog --account you@example.com forms delete-question <formId> <questionId> --force
gog --account you@example.com forms publish <formId>
```

## Safety

- `delete-question` removes content and needs `--force`; `publish` makes the form
  live — confirm the form id.
- Name test forms with a clear temp prefix and trash them after.
- stdout is data (`--json`/`--plain`); hints go to stderr. `--no-input` in automation.

## Discovery

`gog forms --help` · `gog forms <cmd> --help` · `gog schema forms <cmd> --json`
Reference: <https://gogcli.sh/>
