# Google Forms

> Inspect and edit Google Forms, read responses.

Lets an agent list, create, and edit Google Forms and read submitted
responses.

## What it can do

| Method | What it does |
| --- | --- |
| `list_forms` | List Google Forms in Drive; name_contains and page_token optional. |
| `create_form` | Create an empty form with the given title. |
| `get_form` | Get a form's structure by form_id. |
| `list_form_responses` | List submitted responses (forms.responses.list) - requires the responses scope. |
| `batch_update_form` | batchUpdate the form: array of Forms API requests. |

## How to get credentials

Google OAuth - no token to copy.

1. Start setup and enter the Google email.
2. Approve (`forms.body`, `forms.responses.readonly`,
   `drive.metadata.readonly`).

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `USER_GOOGLE_EMAIL` | The Google account owning the forms |

## Troubleshooting

- **Responses empty** - only submissions received after the form was
  created are returned by the API; Google doesn't backfill pre-existing
  data.

## Links

- [Forms API reference](https://developers.google.com/forms/api/reference/rest)