Open navigation

Google connection guide

Follow these steps to connect any Google data source to Supermetrics and use your data in any of our data destinations — Google Sheets, Looker Studio, Excel, data warehouses, and Power BI, as well as the Supermetrics API. You can also connect to data sources from the Supermetrics Hub.


You can share your data source connection with your team and use the connection across all data destinations you use with Supermetrics. Learn more about shared connections.


Note that while these data sources share the same connection steps, each has unique permissions that you need to implement before you're able to connect. Make sure you've assigned these permissions before going ahead.


The following Google data source connectors have their own connection guides:


Before you begin

Select a Google data source from the list below to learn about its permissions and other connection requirements.


Google Ads

You need a Google Ads or manager account with Read Only access. Learn how to grant access to a Google Ads account or manage your accounts


If you have connected to Google Ads correctly, but your ad account doesn't appear, try granting the manager account access again.  

Google Ads Account Explorer

You need a Google Ads account with Standard access. Learn how to grant access to a Google Ads account or manage your accounts.


Monthly invoicing must be enabled for the whole Google Ads account at the Manager Account (MCC) level.

Google AdSense

You need a Google AdSense account with at least the Admin user role. Learn how to manage user access to your account.

Google Ad Manager

You'll need a Google Ad Manager account with at least the Trafficker role. API access must be explicitly enabled by the Administrator. 


Learn about role permissions and how to manage user roles, and how to enable API access

Google Analytics

You need a Google Analytics account with at least Read & Analyze access to a Property and Views underneath. Learn more about user permissions and how to add users.

Google Analytics 4

You need a Google Account with at least Viewer access at the Property and View levels. Learn more about access management in Google Analytics 4.

Google BigQuery

You need BigQuery Data Viewer and BigQuery User role levels for the Dataset, and the BigQuery User role for the Project.


Note that the Google BigQuery data source connector is available only in Google Sheets and Looker Studio.


Google has limited the availability of its access credentials to 16 hours. Adding Supermetrics as a trusted app in the Google admin console can enable scheduled query refreshes and help you avoid daily reauthentication. Learn how to add Supermetrics as a trusted app.


Google BigQuery field list types

  • Simplified field list: Shows each unique field name just once, if it's present in multiple tables.
  • Full-field list: Shows all columns from your tables in BigQuery.
  • Simplified list: With join fields only — shows only the fields that are available for multiple data sources. 
Google Campaign Manager 360

You need a Google Account with an appropriate user role for the reporting content they need to see (this varies based on what the admin set for the role). Read more about user access in Google’s documentation.


You might need API access for the account enabled by a Google representative or the Campaign Manager 360 support team. Learn more about API prerequisites.

Google Display & Video 360

You need a Google Display & Video 360 account with at least a Standard or Admin user role. Learn how to manage user access.

Google My Business

You need a Google Account with at least an Owner or Manager user role. Learn how to add and remove owners and managers.


Please note that you can fetch only limited locations. Learn about usage limits on Google My Business API.

Google Search Ads 360

You need a Google Search Ads 360 account with at least an Agency Manager or Advertiser Manager role. Learn how to add or remove users.


Following Supermetrics' migration to a new Google Ads API in early 2022, it's no longer possible to pull Google Ads data from Search Ads 360 accounts. Remove any Search Ads 360 accounts from your queries to keep them running.

Google Search Console

You need a Google Search Console account with Verified Owner or Delegated Owner access. Verify your site ownership first.


Note that in Looker Studio, you must select a query type to use with Google Search Console. Take a look at our Google Search Console report building guide to learn more about the available query types.


Instructions

Google Sheets

Make sure you've installed the Supermetrics add-on before you connect.

  1. Open a new Google Sheets file.
  2. Navigate to ExtensionsSupermetricsLaunch sidebar to open Supermetrics.
  3. Click Create new query.
  4. Under Data source, select your Google data source.
  5. Choose to make this connection shared or private.
  6. Click Sign in with Google.
  7. Sign in with the Google Account you use with this data source. This doesn't have to be the same as the Google Account you use with Supermetrics.
  8. Click Allow.

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Google Sheets.

Looker Studio
  1. Open the Supermetrics Looker Studio data source gallery.
  2. Navigate to your Google data source and click Start free trial.
  3. You'll see two buttons that read Authorize. If you're using Supermetrics for the first time, click the left-hand one and log in with the Google Account you use with Supermetrics.
  4. Once that's done, or if you've done it before, click the right-hand Authorize button (under "Google requires authorization to connect to data").
  5. Select a team that has access to the account you want to connect.
  6. Choose to make this connection shared or private.
  7. Click Sign in with Google.
  8. Sign in with the Google Account you use with this data source. This doesn't have to be the same as the Google Account you use with Supermetrics.
  9. Click Allow.
  10. Scroll down to the bottom of the page. To create a report with our template, select Use report template for new reports. To create a blank report, deselect this option.
  11. In the pane's top right, click Connect.
  12. Click Create report.
  13. Click Create report again.

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Looker Studio.

Excel

Make sure you've installed the Supermetrics add-on before you connect.

  1. Open an Excel file.
  2. Click DataShow Supermetrics.
  3. Under Data source, select your Google data source.
  4. Choose to make this connection shared or private.
  5. Click Sign in with Google.
  6. Sign in with the Google Account you use with this data source. This doesn't have to be the same as the Google Account you use with Supermetrics.
  7. Click Allow.

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Excel.

Data warehouse

Follow these instructions to set up a transfer with Supermetrics for BigQuery (marketplace). See the instructions below for other data warehouse destinations.


Set up transfer for BigQuery (marketplace)

Make sure you've enrolled the data source before you connect.

  1. Log in to the Google Cloud Platform.
  2. Navigate to BigQueryData transfers.
  3. Click + Create transfer.
  4. Select your Google data source.
  5. Fill in the transfer details. See detailed instructions on how to set up a transfer.
  6. Under Third-party connection, click Connect source.
  7. Accept the agreement.
  8. Click Authorize with your Google data source.
  9. Click Sign in with Google.
  10. Sign in with the Google Account you use with this data source. This doesn't have to be the same as the Google Account you use with Supermetrics.
  11. Click Allow.
  12. Select the accounts you'd like to include in your reporting and define the transfer settings.
  13. Click Submit.
  14. Click Save.


Set up data warehouse transfer on the Supermetrics Hub

Make sure you've set up a data warehouse destination before you connect.

  1. Log in to the Supermetrics Hub.
  2. In the sidebar, go to StorageTransfers.
  3. Click New transfer. If you haven't created any transfers yet, click Schedule first transfer
  4. Select your Google data source, and click OK.
  5. Fill in the transfer details. See detailed instructions on how to set up a transfer.
  6. In the Connections section, click Add new connection.
  7. Click Sign in with Google.
  8. Sign in with the Google Account you use with this data source. This doesn't have to be the same as the Google Account you use with Supermetrics.
  9. Click Allow.
  10. In the transfer setup view, select the accounts you'd like to include in your reporting.
  11. Click Create transfer.
Power BI
  1. Log in to the Supermetrics Hub.
  2. In the sidebar, go to DestinationsPower BI.
  3. Click Create or edit queries.
  4. Click Select a data source.

  5. Select your Google data source.
  6. Click Sign in with Google.
  7. Sign in with the Google Account you use with this data source. This doesn't have to be the same as the Google Account you use with Supermetrics.
  8. Click Allow.
  9. Fill in the query details.
  10. Click Run query to test your query.
The Supermetrics API
  1. Log in to the Supermetrics Hub.
  2. In the sidebar, click API.
  3. Select for Supermetrics API from the dropdown menu next to the page title.
  4. Click Select data source.
  5. Select your Google data source.
  6. Click Sign in with Google.
  7. Sign in with the Google Account you use with this data source. This doesn't have to be the same as the Google Account you use with Supermetrics.
  8. Click Allow.
  9. Fill in the query details. See detailed instructions on how to set up a Supermetrics API query in Query Manager.
  10. Click Run to test your query.
Supermetrics Hub
  1. Log in to the Supermetrics Hub.
  2. In the sidebar, click Data sources.
  3. Scroll down to the list of data sources you haven't connected to. You see this list below your existing connections, under the title Connect to new data source.
  4. Hover over your Google data source, and click Connect.
  5. Click Sign in with Google.
  6. Sign in with the Google Account you use with this data source. This doesn't have to be the same as the Google Account you use with Supermetrics.
  7. Click Allow.


More resources

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.