> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Sheets Connector

## Intro

Google Sheets is a spreadsheet program, part of a free, web-based software office suite offered

by Google within its Google Drive service. The program allows users to create and edit spreadsheets online while collaborating with other users in real-time. To learn more about the Google API, visit their website ([https://developers.google.com](https://developers.google.com/sheets/api/reference/rest "https://developers.google.com") ).

The Google Sheets connector is a "Cloud App" connector, meaning it pulls data from a cloud-based application into Domo. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window.

<table class="mt-responsive-table"><tbody><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Use Cases </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> This connector is appropriate for data sources in which multiple users are contributing to a single data source. </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Metrics </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> Users can create a wide variety of metrics using Google Sheet DataSets. Some frequently used metrics are... </p><ul><li><p> Tracking a list of items </p></li><li><p> People </p></li><li><p> Help requests </p></li><li><p> Company assets </p></li><li><p> Employee compliance / trainings </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Company Roles </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> Appropriate for all roles </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Average Implementation Time </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 10 minutes or less </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Ease of Use (on a 1-to-10 scale with 1 being easiest) </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 2 </p></td></tr></tbody></table>

### Other panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## Best practices

Google Forms (surveys) don't currently have a connector; however, you can convert Google Forms into Google Sheets, which can then be pulled into Domo with the Google Sheets connector.

## Prerequisites

To connect to your Google account and create a Google Sheets DataSet, you must have Google credentials.

## Connecting to Your Google account

This section enumerates the options in the **Credentials** and **Details** panes in the Google Sheets Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet,** are universal across most connector types and are discussed in greater length in \[Adding a DataSet Using a Connector]\([https://domo-support.domo.com/s/article/360042926274?language=en\_USAdding](https://domo-support.domo.com/s/article/360042926274?language=en_USAdding) a DataSet Using a Connector "Adding a DataSet Using a Connector").

### Credentials pane

The Domo Google Sheets connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click **Connect** (or select **Add Account** if you have existing Google Sheets accounts in Domo) to open the Google OAuth screen where you can enter your Google credentials. Once you have entered valid Google credentials, you can use the same account any time you go to create a new Google Sheets  DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector/Adapter Accounts](https://domo-support.domo.com/s/article/360042926054?language=en_US "Manage Connector/Adapter Accounts").

<Note>
  **Note:** If you are already logged into Google when you connect in Domo, you are authenticated automatically when you click **Add account**. If you want to connect to an account that is different from the one you are logged into, you must first log out of Google.
</Note>

### Details Pane

In this pane, you specify the Google Drive file you want to import into Domo and set options for how you want to data to appear.

<table border="1" cellpadding="1" cellspacing="1"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Spreadsheet ID </p></td><td colspan="1" rowspan="1"><p> Enter the ID of the Google Sheet you want to pull into Domo. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Worksheet Name </p></td><td colspan="1" rowspan="1"><p> Select the specific worksheet you want to pull into Domo. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Spreadsheet Layout </p></td><td colspan="1" rowspan="1"><p> Select whether your Google Sheet has column headers or row headers. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Manually Enter Cell Ranges </p></td><td colspan="1" rowspan="1"><p> Check this box if you want to specify a that certain range of data from the spreadsheet be pulled into Domo. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Column Header Cell Range </p></td><td colspan="1" rowspan="1"><p> Enter the range for the column headers you want to be imported into Domo. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Column Data Cell Range </p></td><td colspan="1" rowspan="1"><p> Enter the range for the data you want to be imported into Domo. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Force To String </p></td><td colspan="1" rowspan="1"><p> Enter a comma separated list of columns in the selected worksheet that you would like to import as text fields. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Date Format </p></td><td colspan="1" rowspan="1"><p> Select the date format which is used in the selected file. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## FAQs

<AccordionGroup>
  <Accordion title="How do I know my Google credentials are secure?">
    The login process uses the OAuth process, so your Google credentials are never seen or stored by Domo. You can revoke Domo's access to your account at any time.
  </Accordion>

  <Accordion title="How often can the data be updated?">
    As often as needed.
  </Accordion>

  <Accordion title="Are there any API limits I should be aware of?">
    Google enforces total and concurrent call rate limits. To prevent rate limiting, reduce the number of DataSets scheduled to run at the same time.
  </Accordion>

  <Accordion title="Why does the connector seem to be pulling in unwanted data?">
    Confirm that you have selected the correct Google Sheet worksheet. If you are using advanced options, make sure you have selected the correct range of data.
  </Accordion>

  <Accordion title="Why can't I create a new DataSet using the Google Sheets Connector account I have been using?">
    The Google Sheets Connector has been upgraded due to Google's API restrictions. In the current version 2 or higher versions, the accounts used in the previous version 1 cannot be selected as they are. You need to create a new account and create a DataSet.
  </Accordion>
</AccordionGroup>

## Troubleshooting

* If the connection fails, confirm the Google account username and password are still accurate.
* If the connector seems to pull back the wrong data, confirm you selected the correct Google Sheet worksheet or, if using advanced options, confirm you have the correct range of data selected.
