Googleforms
googleformsGoogle Forms is a survey administration software that allows users to create and share online forms and surveys.
Acciones disponibles (7)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Batch Update FormGOOGLEFORMS_BATCH_UPDATE_FORMAcciónApplies a batch of update operations to a Google Form in a single atomic transaction. Use when you need to modify form content after creation, including: - Adding, updating, or deleting questions and other items - Modifying form metadata (title, description) - Updating form settings (quiz mode, email collection) - Reorganizing item order within the form All updates in the batch are applied together atomically. If any update fails, the entire batch is rolled back. Use writeControl for optimistic concurrency to ensure updates are applied to the expected form version. Note: The form must have the appropriate sharing settings for the authenticated user to modify it.
GOOGLEFORMS_BATCH_UPDATE_FORMAcciónApplies a batch of update operations to a Google Form in a single atomic transaction. Use when you need to modify form content after creation, including: - Adding, updating, or deleting questions and other items - Modifying form metadata (title, description) - Updating form settings (quiz mode, email collection) - Reorganizing item order within the form All updates in the batch are applied together atomically. If any update fails, the entire batch is rolled back. Use writeControl for optimistic concurrency to ensure updates are applied to the expected form version. Note: The form must have the appropriate sharing settings for the authenticated user to modify it.
Parámetros de entrada
formIdstringObligatorioRequired. The ID of the form to update.
requestsobject[]ObligatorioRequired. The update requests to apply to the form. Each request is a dictionary containing exactly one request type: **Available request types:** - `createItem` - Add a new item (question) to the form. Requires `item` (the item definition) and `location` (where to place it). - `updateFormInfo` - Update form metadata. Requires `info` (title, description) and `updateMask` (fields to update). - `updateSettings` - Update form settings. Requires `settings` and `updateMask`. - `updateItem` - Update an existing item. Requires `item`, `location`, and `updateMask`. - `moveItem` - Move an item to a new location. Requires `originalLocation` and `newLocation`. - `deleteItem` - Delete an item. Requires `location` with the index of the item to delete. All updates are applied atomically - if any update fails, the entire batch is rolled back.
writeControlobjectProvides control over how write requests are executed.
includeFormInResponsebooleanWhether to return the updated form in the response. Set to true to get the complete form with all applied mutations.
Parámetros de salida
dataanyObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create a Google FormGOOGLEFORMS_CREATE_FORMAcciónCreates a new Google Form with the specified title. This action initializes an empty form that can be later populated with items (questions, sections, images, videos) using the batchUpdate endpoint. When a form is created, it is assigned a unique formId that is required for all subsequent operations on that form. As of June 30, 2026, forms created via API will default to an unpublished state, giving creators control over responder access before making the form publicly available. Use this action when you need to create a new form for collecting information, surveys, quizzes, or feedback. After creation, use the batchUpdate action to add questions and other items to the form.
GOOGLEFORMS_CREATE_FORMAcciónCreates a new Google Form with the specified title. This action initializes an empty form that can be later populated with items (questions, sections, images, videos) using the batchUpdate endpoint. When a form is created, it is assigned a unique formId that is required for all subsequent operations on that form. As of June 30, 2026, forms created via API will default to an unpublished state, giving creators control over responder access before making the form publicly available. Use this action when you need to create a new form for collecting information, surveys, quizzes, or feedback. After creation, use the batchUpdate action to add questions and other items to the form.
Parámetros de entrada
infoobjectObligatorioRequired. Form info object containing the title and optional document title.
unpublishedbooleanOptional. 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.
Parámetros de salida
dataanyObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Google FormGOOGLEFORMS_GET_FORMAcciónRetrieves the complete structure and metadata of a Google Form. Returns the full form definition including its title, description, all items (questions, sections, page breaks, images, videos, and display text), form settings (quiz mode, email collection), publishing state, and output-only fields such as the responder submission URL and revision ID. This action is read-only and does not modify the form. Use this action when you need to read the current configuration of a form, display its structure to users, inspect its settings, or check its publishing state before making updates.
GOOGLEFORMS_GET_FORMAcciónRetrieves the complete structure and metadata of a Google Form. Returns the full form definition including its title, description, all items (questions, sections, page breaks, images, videos, and display text), form settings (quiz mode, email collection), publishing state, and output-only fields such as the responder submission URL and revision ID. This action is read-only and does not modify the form. Use this action when you need to read the current configuration of a form, display its structure to users, inspect its settings, or check its publishing state before making updates.
Parámetros de entrada
formIdstringObligatorioRequired. The unique ID of the form to retrieve. The form ID can be found in the URL after 'forms/d/' when viewing the form in Google Forms.
Parámetros de salida
dataanyObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get form responseGOOGLEFORMS_GET_RESPONSEAcciónRetrieves a single form response by its unique response ID. Returns complete response data including all answers provided by the respondent, their email (if collected), timestamps, and quiz scores (if applicable). Use this action when you need to fetch detailed information about a specific submission, such as viewing individual submissions, verifying response data, or building response detail views.
GOOGLEFORMS_GET_RESPONSEAcciónRetrieves a single form response by its unique response ID. Returns complete response data including all answers provided by the respondent, their email (if collected), timestamps, and quiz scores (if applicable). Use this action when you need to fetch detailed information about a specific submission, such as viewing individual submissions, verifying response data, or building response detail views.
Parámetros de entrada
form_idstringObligatorioRequired. The form ID of the form to retrieve a response from.
response_idstringObligatorioRequired. The response ID to retrieve. This is the unique identifier for a specific form submission.
Parámetros de salida
dataanyObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Google Form ResponsesGOOGLEFORMS_LIST_RESPONSESAcciónLists all responses submitted to a Google Form with optional filtering and pagination. Use this action to retrieve multiple form submissions at once, export response data, or monitor new submissions. Supports filtering by timestamp to fetch only responses submitted after a specific time, which is useful for incremental data synchronization.
GOOGLEFORMS_LIST_RESPONSESAcciónLists all responses submitted to a Google Form with optional filtering and pagination. Use this action to retrieve multiple form submissions at once, export response data, or monitor new submissions. Supports filtering by timestamp to fetch only responses submitted after a specific time, which is useful for incremental data synchronization.
Parámetros de entrada
filterstringA filter expression to return only responses that match the specified condition. Supports timestamp > N or timestamp >= N in RFC3339 UTC 'Zulu' format (e.g., '2024-01-15T00:00:00Z'). Use this for incremental data synchronization to fetch only new responses.
form_idstringObligatorioRequired. The ID of the Form whose responses to list. You can find the form ID in the form URL: https://forms.google.com/forms/d/{formId}/edit
page_sizeintegerThe maximum number of responses to return. If unspecified, at most 5000 responses are returned. Use pageToken to iterate through pages.
page_tokenstringA page token returned by a previous list response. Use this to retrieve the next page of results.
Parámetros de salida
dataanyObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Form WatchesGOOGLEFORMS_LIST_WATCHESAcciónLists all watches owned by the calling project for a specific Google Form. Use this action to discover existing watches, check their status and expiration times, or audit which notifications are configured for a form. Each project can have a maximum of 2 watches per form (one for each event type: SCHEMA and RESPONSES). The SCHEMA event type monitors changes to form content or settings, while RESPONSES monitors new form submissions.
GOOGLEFORMS_LIST_WATCHESAcciónLists all watches owned by the calling project for a specific Google Form. Use this action to discover existing watches, check their status and expiration times, or audit which notifications are configured for a form. Each project can have a maximum of 2 watches per form (one for each event type: SCHEMA and RESPONSES). The SCHEMA event type monitors changes to form content or settings, while RESPONSES monitors new form submissions.
Parámetros de entrada
form_idstringObligatorioRequired. ID of the Form whose watches to list. The form ID can be found in the form URL: https://docs.google.com/forms/d/{formId}/edit
Parámetros de salida
dataanyObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set Form Publish SettingsGOOGLEFORMS_SET_PUBLISH_SETTINGSAcciónUpdates the publishing settings of a Google Form, controlling whether the form is published (visible to others) and whether it accepts responses. Use this action to publish a draft form, unpublish a form to prevent access, or toggle response collection on/off without changing the form's visibility. Note that legacy forms created before the publish settings feature was introduced cannot use this endpoint and will return an error.
GOOGLEFORMS_SET_PUBLISH_SETTINGSAcciónUpdates the publishing settings of a Google Form, controlling whether the form is published (visible to others) and whether it accepts responses. Use this action to publish a draft form, unpublish a form to prevent access, or toggle response collection on/off without changing the form's visibility. Note that legacy forms created before the publish settings feature was introduced cannot use this endpoint and will return an error.
Parámetros de entrada
form_idstringObligatorioRequired. The ID of the form to update. You can get the form ID from the Form.form_id field.
updateMaskstringOptional. The publishSettings fields to update. Accepts: 'publishState' or '*' for all fields. If not provided, all fields are updated.
publishSettingsobjectObligatorioRequired. The desired publish settings to apply to the form.
Parámetros de salida
dataanyObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not