Google Forms

Usage Instructions

Integrate Google Forms into your workflow. Read form structure, get responses, create forms, update content, and manage notification watches.

Tools

`google_forms_get_responses`

Input

Parameter	Type	Required	Description
`formId`	string	Yes	No description
`responseId`	string	No	No description
`pageSize`	number	No	Maximum number of responses to return (service may return fewer). Defaults to 5000.

Output

Parameter	Type	Description
`responses`	array	Array of form responses (when no responseId provided)
↳ `responseId`	string	Unique response ID
↳ `createTime`	string	When the response was created
↳ `lastSubmittedTime`	string	When the response was last submitted
↳ `answers`	json	Map of question IDs to answer values
`response`	object	Single form response (when responseId is provided)
↳ `responseId`	string	Unique response ID
↳ `createTime`	string	When the response was created
↳ `lastSubmittedTime`	string	When the response was last submitted
↳ `answers`	json	Map of question IDs to answer values
`raw`	json	Raw API response data

`google_forms_get_form`

Input

Parameter	Type	Required	Description
`formId`	string	Yes	No description

Output

Parameter	Type	Description
`formId`	string	The form ID
`title`	string	The form title visible to responders
`description`	string	The form description
`documentTitle`	string	The document title visible in Drive
`responderUri`	string	The URI to share with responders
`linkedSheetId`	string	The ID of the linked Google Sheet
`revisionId`	string	The revision ID of the form
`items`	array	The form items (questions, sections, etc.)
↳ `itemId`	string	Item ID
↳ `title`	string	Item title
↳ `description`	string	Item description
`settings`	json	Form settings
`publishSettings`	json	Form publish settings

`google_forms_create_form`

Input

Parameter	Type	Required	Description
`title`	string	Yes	No description
`documentTitle`	string	No	No description
`unpublished`	boolean	No	No description

Output

Parameter	Type	Description
`formId`	string	The ID of the created form
`title`	string	The form title
`documentTitle`	string	The document title in Drive
`responderUri`	string	The URI to share with responders
`revisionId`	string	The revision ID of the form

`google_forms_batch_update`

Input

Parameter	Type	Required	Description
`formId`	string	Yes	No description
`requests`	json	Yes	Array of update requests (updateFormInfo, updateSettings, createItem, updateItem, moveItem, deleteItem)
`includeFormInResponse`	boolean	No	No description

Output

Parameter	Type	Description
`replies`	array	The replies from each update request
`writeControl`	object	Write control information with revision IDs
↳ `requiredRevisionId`	string	Required revision ID for conflict detection
↳ `targetRevisionId`	string	Target revision ID
`form`	object	The updated form (if includeFormInResponse was true)
↳ `formId`	string	The form ID
↳ `info`	object	Form info containing title and description
↳ `title`	string	The form title visible to responders
↳ `description`	string	The form description
↳ `documentTitle`	string	The document title visible in Drive
↳ `settings`	object	Form settings
↳ `quizSettings`	object	Quiz settings
↳ `isQuiz`	boolean	Whether the form is a quiz
↳ `emailCollectionType`	string	Email collection type
↳ `revisionId`	string	The revision ID of the form
↳ `responderUri`	string	The URI to share with responders
↳ `linkedSheetId`	string	The ID of the linked Google Sheet
↳ `publishSettings`	object	Form publish settings
↳ `publishState`	object	Current publish state
↳ `isPublished`	boolean	Whether the form is published
↳ `isAcceptingResponses`	boolean	Whether the form is accepting responses

`google_forms_set_publish_settings`

Input

Parameter	Type	Required	Description
`formId`	string	Yes	No description
`isPublished`	boolean	Yes	No description
`isAcceptingResponses`	boolean	No	No description

Output

Parameter	Type	Description
`formId`	string	The form ID
`publishSettings`	json	The updated publish settings
↳ `publishState`	object	The publish state
↳ `isPublished`	boolean	Whether the form is published
↳ `isAcceptingResponses`	boolean	Whether the form accepts responses

`google_forms_create_watch`

Input

Parameter	Type	Required	Description
`formId`	string	Yes	No description
`eventType`	string	Yes	No description
`topicName`	string	Yes	No description
`watchId`	string	No	No description

Output

Parameter	Type	Description
`id`	string	The watch ID
`eventType`	string	The event type being watched
`topicName`	string	The Cloud Pub/Sub topic
`createTime`	string	When the watch was created
`expireTime`	string	When the watch expires (7 days after creation)
`state`	string	The watch state (ACTIVE, SUSPENDED)

`google_forms_list_watches`

Input

Parameter	Type	Required	Description
`formId`	string	Yes	No description

Output

Parameter	Type	Description
`watches`	array	List of watches for the form
↳ `id`	string	Watch ID
↳ `eventType`	string	Event type (SCHEMA or RESPONSES)
↳ `createTime`	string	When the watch was created
↳ `expireTime`	string	When the watch expires
↳ `state`	string	Watch state

`google_forms_delete_watch`

Input

Parameter	Type	Required	Description
`formId`	string	Yes	No description
`watchId`	string	Yes	No description

Output

Parameter	Type	Description
`deleted`	boolean	Whether the watch was successfully deleted

`google_forms_renew_watch`

Input

Parameter	Type	Required	Description
`formId`	string	Yes	No description
`watchId`	string	Yes	No description

Output

Parameter	Type	Description
`id`	string	The watch ID
`eventType`	string	The event type being watched
`expireTime`	string	The new expiration time
`state`	string	The watch state

Google Forms

On this page