Skip to main content
waffle.svg
Domo Knowledge Base

Google Sheets Writeback Connector

  1. Last updated
  2. Save as PDF
Version 8

 

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. Use this connector to export your data from a Domo DataSet to a Google Sheet. To learn more about the Google API, visit their page (https://developer.google.com).

You export data to Google Sheets in the Data Center. This topic discusses the fields and menus that are specific to the Google Sheets Writeback connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

Prerequisites

To configure this connector, you will need the following:

  • A project created in the Google Developers Console with the Google Sheets API enabled.

  • A Domo Client ID and Client Secret.

  • A Google Service Token JSON file. 

The following steps explain in detail how to create your project and obtain the needed credentials. 

Step 1: Creating a Project in the Google Developers Console

To create a project in the Google Developers Console, do the following:

  1. Go to https://console.developers.google.com.

  2. Click the dropdown arrow next to My Project.

    googlesheets_writeback_1.png
     

  3. Click New Project.

    googlesheets_writeback_2.png

  4. Name your project and select the parent folder.

  5. Click Create. 

    Note: You can also use an existing project if you want.    

Step 2: Enabling the Google Sheets API

To enable the Google Sheets for your project, do the following:

  1. In the Google Developers Console, select your project and click Library.

    googlesheets_writeback_3.png

  2. Search for the Google Sheets API.

  3. Click Enable.

    googlesheets_writeback_4.png

Step 3: Creating a Service Account

To create a Service Account, do the following:

  1. In the Google Developers Console, open the Credentials tab.

  2. Click Create credentials then select Service account key.

    googlesheets_writeback_5.png

  3. Select New service account.

  4. Name the new service account.

  5. In the Role dropdown, select Project > Owner.

  6. For the Key type, select JSON.

    googlesheets_writeback_6.png

  7. Click Create, then Save.

  8. Select a safe location for the file, as you will need it soon.

  9. Once the file is created, click Manage service accounts on the far right.

    googlesheets_writeback_7.png

  10. Copy the email address for the project you created.

    googlesheets_writeback_8.png

  11. Open https://sheets.google.com and create a new sheet.

  12. Share the sheet with the email address you copied in step 10. (The email address owner must have at least Editor-level privileges.)

  13. Copy the URL to the spreadsheet, as you will need it later.

    The spreadsheet URL should look similar to the following: 

    docs.google.com/spreadsheets/d/<googlesheetID>/edit#gid=0

Step 4: Creating a Domo Client ID and Client Secret

To create a Domo client ID and client secret, do the following:

  1. Navigate to https://developer.domo.com and log in.

  2. Click New Client (found under "My Account" in the top right corner).

  3. Create a new client with Application Scopes of Data and User.

    googlesheets_writeback_9.png

    When you click Create, you will be redirected to the client ID and client secret.

  4. Copy the client ID and client secret, as you will need them soon.

Configuring the Connection

This section enumerates the options in the Credentials and Details panes in the Google Sheets Writeback 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 Data Connector.

Credentials Pane

This pane contains fields for entering credentials to connect to your Domo developer account as well as your Google Sheet. The following table describes what is needed for each field:  

Field

Description

Domo Client ID

Paste the Domo client ID you copied in Step 4: Creating a Domo Client ID and Client Secret, in the "Prerequisites" section above.

Domo Client Secret

 Paste the Domo client secret you copied in Step 4: Creating a Domo Client ID and Client Secret, in the "Prerequisites" section above.

Service Token JSON

Paste the JSON Service Token you generated in Step 3: Creating a Service Account, in the "Prerequisites," above.

googlesheets_writeback_10.png

Once you have entered valid credentials, you can use the same account any time you go to set up a new Domo-Google Sheets connection. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

Details Pane

This pane contains a number of fields for specifying your data and indicating where it's going.

Menu

Description
Input Sheet ID

Enter the ID of the Google Sheet you want to push your data to. This is the portion of the URL between /d/ and /edit. For example, in the URL https://docs.google.com/spreadsheets/d/18z/N0RQ8HIaEj2USwtAkCMX7AKBI-x-_vq24kPd4_Tsk/edit#gid=0, the ID is N0RQ8HIaEj2USwtAkCMX7AKBI-x-_vq24kPd4_Tsk.  

Input DataSet ID

Enter the DataSet ID (GUID) for the DataSet you want to copy to a Google Drive folder. You can find the ID by opening the details view for the DataSet in the Data Center and looking at the portion of the URL following datasources/. For example, in the URL https://mycompany.domo.com/datasources/845305d8-da3d-4107-a9d6-13ef3f86d4a4/details/overview, the DataSet ID is 845305d8-da3d-4107-a9d6-13ef3f86d4a4. 

googlesheets_writeback_11.png

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 Data Connector.