This guide gives instructions on how to successfully authenticate Google BigQuery. Please note that this data source is available only with Google Sheets and not yet with Microsoft Excel. We also offer this connector with Data Studio but only as part of BigQuery license or BigQuery trial account.
Quick links to specific sections:
"If everything fails..."
- Common Errors when authenticating
- Forcing a Refresh for Account Data
- Removing a Data Source
- Refreshing tokens
Data Source Access Requirements:
Before authenticating the connector, please make sure you have gone through the rights and permissions required for this data source, meaning you are assigned as an "ad manager/admin" or as a similar role. To learn more, please refer to these guides:
Access requirements for user account:
For Dataset, you will need both BigQuery Data Viewer and BigQuery User role levels.
For Project, you will need only a BigQuery User role level.
- BiqQuery Data Viewer
When applied to a dataset, this role provides permissions to:
- Read the dataset's metadata and list tables in the dataset.
- Read data and metadata from the dataset's tables.
- BigQuery User
Provides permissions to run jobs, including queries, within the project. The user role can enumerate their own jobs, cancel their own jobs, and enumerate datasets within a project. Additionally, allows the creation of new datasets within the project; the creator is granted the BigQuery Data Owner role for these new datasets.
Authenticating with Google Sheets:
To authenticate Google BigQuery in Google Sheets, please do the following steps:
1. Open up the Supermetrics sidebar in your Google Sheets.
2. Select Google BigQuery in the sidebar, under data source.
3. Choose an account to sign in.
5. You have completed all the steps. You can now go back to the sidebar and select your Google BigQuery account.
To re-authenticate Google BigQuery in Google Sheets, please go to this guide.
To authenticate Google BigQuery in Google Data Studio, please do the following steps:
1. Click on add data.
2. Search for Google BigQuery by Supermetrics and click on it.
3. Select BigQuery dataset.
4. Choose the field list type. If you are working with a dataset with lots of tables and fields, this setting will simplify the field list to include only fields that are common to multiple data sources.
You can choose between:
- Full field list
- Simplified field list
- Simplified list with join fields only
5. Click on add on the bottom right side to continue.
6. As a final step, click on add to report.
To re-authenticate Google BigQUery in Data Studio, please go to this guide.
If you encounter any of the following errors below, please see the guide linked after the error message.
- Error: "This was a reauthorization request for user X but logged in as user Y", please see this guide.
- Error: "You're not allowed to run queries with this license #12345. This is because you have not been assigned to the license as a valid user." please see this guide.
- Error: "This action is not supported when you are signed into multiple accounts". please see this guide.
- If you no longer see a specific account/page/etc. when logging in, please see this guide.
- If you haven't managed to authenticate you might be affected by an issue at Google account management. For more information, please see this guide.
To force a refresh per data source, please see this guide.
To remove a data source from Google Sheets, please see this guide.
To remove a data source from Data Studio, please see this guide.
To remove a data source from Excel, please see this guide.
As a final step, if you wish your tokens to be refreshed, please create a support ticket.