Set up a connection to Google Contacts

Google Contacts is a contact management service. You can sync Google Contacts with other systems, such as CRM and ERP applications. When you configure this connection, you will be prompted to sign in to the Google account and authorize integrator.io access.

Google Contacts API documentation: API guide, Authentication
Additional reference: Supported Google Contacts APIs

Contents

• A. Set up a Google Contacts connection
• B. Provide Google Contacts account information
  • Retrieve your Google Contacts Client ID and Client secret
• C. Edit advanced Google Contacts settings
• D. Save and authorize

A. Set up a Google Contacts connection

Start establishing a connection to Google Contacts in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
  – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select Google Contacts.

The Create connection panel opens with required and advanced settings.

B. Provide required Google Contacts account information

At this point, you’re presented with a series of options for providing Google Contacts authentication.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing.

API type: Contacts API [Deprecated]

The following options are available when you select the API type as Contacts API [Deprecated]:

Configure scopes (required): Scopes are permissions that the Google API defines to limit access to your account. The following scopes are available:

1. Click the Configure scopes button.
2. To access all of the scopes in the API, click the » button.
       – or –
   Check the scopes you want to add and click the > button.
3. Click Save to save your scopes and leave the editor.

API type: People API

The following options are available when you select the API type as People API:

IClient (required): Select the iClient that stores the client ID and client secret provided to you by Google Contacts. To add an iClient and configure your credentials, click the plus (+) button. Click the edit ( ) button to modify a selected iClient. Provide a clear and distinguishable name to use in any other connections. Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s client secret safe. When editing the iClient at any point, you must enter the secret value again; it is stored only when the connection is saved and never displayed as text.

Retrieve your Google Contacts Client ID and Client secret.

1. Sign in to your Google Developer Console account.
2. Navigate to APIs & Services > Credentials.
3. Click Configure consent screen. The OAuth consent screen page appears.

4. Select your application user type, either Internal or External, and click Create. The Edit app registration page appears.

Notes:

• Celigo recommends setting your application to internal OAuth to make it available for your organization's users only.
• When the external OAuth application is in testing mode, the refresh token expires every seven days. Hence, you have to re-authorize the connection by clicking the Save and authorize on the Google Contacts connection page.

5. Provide the App name, email, and add integrator.io to the Authorized domains list.

6. You can add or remove the scopes that you have selected in integrator.io and click Save and continue.
7. Navigate to Credentials > Create Credentials and click OAuth client ID. The Create OAuth client ID page appears.

8. From the Application type drop-down list, select the Web application.
9. Provide the Name, paste the redirect URL in the Authorized redirect URIs, and click Create.

10. Copy your Client ID and Client secret.

Redirect URL (read-only): Copy this integrator.io redirect URL to provide directions to Google Contacts for where to go after authentication. (This URL should be whitelisted with the authorization server.)

Configure scopes (required): Scopes are permissions that the Google API defines to limit access to your account. The following scopes are available:

1. Click the Configure scopes button.
2. To access all of the scopes in the API, click the » button.
       – or –
   Check the scopes you want to add and click the > button.
3. Click Save to save your scopes and leave the editor.

C. Edit advanced Google Contacts settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the Google Contacts connection.

D. Save and authorize

To save and authorize the Google Contacts connection:

1. Click Save & authorize to commit your changes and proceed to log in with Google Contacts.
2. Sign in to Google with the user account containing the contacts you want integrator.io to be able to access through this connection.
3. After signing in, review the permissions for the integration and click Allow.

The new connection is now successfully added to your account. If you created it within a flow, it is applied to the current source or destination app. Otherwise, you can proceed to register the connection with an integration.