> ## 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 Contacts Service Connector

## Intro

Google Contacts is an online address book that integrates with other Google products such as Gmail, Google Calendar, and Google Drive. To learn more about the Google Contacts API, visit their page ([https://developers.google.com/google...s/contacts/v3/](https://developers.google.com/google-apps/contacts/v3/ "https://developers.google.com/google-apps/contacts/v3/") ).

You connect to your Google Service account in the Data Center. This topic discusses the fields and menus that are specific to the Google Contacts Service 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](/s/article/360042926274).

## Prerequisites

To connect to your Google service account and create a DataSet, you must have the following:

* A Google service account JSON key
* The email address of the user the application is trying to impersonate in the service account flow

To generate a JSON key, do the following:

1. In the GCP Console, open the IAM & Admin page.
2. Click
   ****Service accounts**** in the left-hand navigation pane.
3. Select your project and click
   ****Open****.
4. Click
   ****Create Service Account****.
5. Enter a name and description for the service account.
6. Click
   ****Create****.
7. Select
   ****Project Owner****.
8. Click
   ****Continue****.
9. Click
   ****Create key****.
10. Select JSON as the key type.
11. Click
    ****Create****.

A private key will be saved to your computer.

## Connecting to Your Google Contacts Service Account

This section enumerates the options in the **Credentials** and **Details** panes in the Google Contacts Service 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](/s/article/360042926274).

### Credentials Pane

This pane contains fields for entering credentials to connect to your Google service account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Field </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Service Account Key JSON </p></td><td colspan="1" rowspan="1"><p> Copy and paste the JSON for your Google service account key. For information about creating a key, see "Prerequisites," above. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Service Account User </p></td><td colspan="1" rowspan="1"><p> Enter the email address of the user the application is trying to impersonate in the service account flow. </p></td></tr></tbody></table>

Once you have entered valid credentials, you can use the same account any time you go to create a new Google Contacts Service DataSet. 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](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a primary menu from which you select your desired Google Contacts report type.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><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> Report </p></td><td colspan="1" rowspan="1"><p> Select the Google Contacts report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"> Contacts </td><td colspan="1" rowspan="1"> Retrieves your list of contacts from Google. </td></tr><tr><td colspan="1" rowspan="1"> Contact Groups </td><td colspan="1" rowspan="1"> Retrieves your list of contact groups from Google. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Person Fields </td><td colspan="1" rowspan="1"> Select the fields (columns) you want to appear in your report. </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 Data Connector](/s/article/360042926274).