# Google Forms

Google Forms is a free, web-based tool by Google that allows users to create surveys, quizzes, and data collection forms. It enables real-time response tracking, seamless integration, and collaboration with multiple users. With features like conditional logic, file uploads, and automated data validation, Google Forms simplifies data gathering and workflow automation.

### **How to Integrate Google Forms with ZBrain Flow** <a href="#how-to-integrate-google-forms-with-zbrain-flow" id="how-to-integrate-google-forms-with-zbrain-flow"></a>

To integrate Google Forms with ZBrain Flow, follow these steps:

1. **Initiate Google Forms Integration**
   * Click the ‘+’ button to add a new integration.
2. **Search for Google Forms**
   * In the search bar, type “Google Forms” and select it from the available integrations.
3. **Choose an Action**
   * Select the action you need, such as retrieving responses or creating a custom API call.

### **How to Connect Google Forms to ZBrain Flow** <a href="#how-to-connect-google-forms-to-zbrain-flow" id="how-to-connect-google-forms-to-zbrain-flow"></a>

To enable seamless interaction between Google Forms and ZBrain Flow, you need to establish a secure connection using OAuth authentication.

#### **Connection Establishment Steps** <a href="#connection-establishment-steps" id="connection-establishment-steps"></a>

1. **Enter a Connection Name**
   * Provide a unique name to identify your Google Forms connection in ZBrain Flow.
2. **Click 'Connect'**
   * This will initiate the authentication process for Google Forms.
3. **Log in to Google Forms**
   * A Google login pop-up will appear.
   * Enter your Google account credentials and proceed.
4. **Grant Permissions**
   * Approve the required OAuth permissions for ZBrain Flow.
   * This allows ZBrain Flow to retrieve responses and manage form data securely.
5. **Save the Connection**
   * Click ‘Save’ to finalize the connection setup.

### **Actions Available in ZBrain Flow** <a href="#actions-available-in-zbrain-flow" id="actions-available-in-zbrain-flow"></a>

#### **Custom API Call** <a href="#custom-api-call" id="custom-api-call"></a>

The Custom API Call feature allows users to directly interact with the Google Forms API, enabling advanced operations and custom integrations beyond standard actions.

**Configuration Steps**

1. **Select an Existing Connection or Create a New One**
   * Choose a previously created Google Forms connection or create a new one.
2. **Enter the API Endpoint URL**
   * Use a full URL or relative path to the Google Forms API.
   * Example API Endpoint:

     `https://forms.googleapis.com/v1/forms/{formId}/responses`
3. **Select the HTTP Method**
   * Choose the request type based on the action needed:
     * **GET** – Retrieve form details or responses.
     * **POST** – Submit responses programmatically.
     * **PATCH** – Modify form metadata, update settings, or change response configurations.
     * **PUT** – Replace existing form configurations.
     * **DELETE** – Remove responses or form entries.
     * **HEAD** – Fetch response headers without retrieving actual data.
4. **Add Headers**
   * Define additional headers required for the API request.
   * Authorization headers are automatically injected.
   * Click ‘+ Add Item’ to include more headers.
5. **Add Query Parameters**
   * Customize API requests with query parameters to filter results or specify additional options.
   * Click ‘+ Add Item’ to add parameters.
6. **Enter JSON Body**
   * Provide structured request data in JSON format.
   * Example JSON request:

{% code lineNumbers="true" %}

```
{
  "responses": [
    {
      "formId": "1234567890abcdef",
      "answers": {
        "question1": "Response 1",
        "question2": "Response 2"
      }
    }
  ]
}
```

{% endcode %}

* **Set Timeout (in Seconds)**
  * Define the request timeout duration to prevent long-running API calls from stalling the process.

**Note:** Click *'f'* to insert dynamic values for flexible configurations.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/flows/flow-components/google-forms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
