Google Contacts Connection
See the Connector Marketplace topic. Please request your administrator to start a trial or subscribe to the Premium Google Contacts connector.
Google Contacts is a contact management service developed by Google.
This topic describes how to authenticate to Google Contacts and configure any necessary connection properties in the Google Contacts connection connector.
Prerequisites
Enable the People API
Follow these steps to enable the People API:
Navigate to the Google Cloud Console.
Select Library from the left-hand navigation menu. This opens the Library page.
In the search field, enter “People API” and select People API from the search results.
On the People API page, click ENABLE.
Connection Configuration
Each connection property available in the Google Contacts connector is explained below.
Connection Name
The name of the connection to be created should be provided. This is the name that will display on the list of available connections.
Auth Scheme
The type of authentication to use when connecting to Google Contacts.
Possible Values
OAuth2
Set this to use OAuth2 authentication.
If OAuth2 is selected, additional configuration parameters will get listed.
Client ID
The client ID assigned when you register your application with an OAuth authorization server.
Client Secret
The client secret assigned when you register your application with an OAuth authorization server.
Refresh Token
The OAuth refresh token for the corresponding OAuth access token.
Service Account
Set this to use Service Account as authentication.
If Service Account is selected, additional configuration parameters will get listed.
Certificate Type
The type of key store containing the Service Account Certificate.
Possible Values
JSON
Set this to use a certificate with type as JSON, for authentication.
If JSON is selected, proceed by uploading the keystore file.
PFX
Set this to use a certificate with type as P12, for authentication.
If PFX is selected, additional configuration parameters will get listed.
Certificate Issuer: Set this to the email address of the service account. This address will usually include the domain iam.gserviceaccount.com.
Certificate Password: Set this to the .pfx file password. In most cases you must provide this since Google encrypts PFX certificates.
Upload File
Upload Service Account Certificate. Use JSON file if Certificate Type is JSON, else use PFX(P12).
After entering all the details, click on the TEST button.
If the connection service identification and authentication details are provided correctly, a success message stating “connection available” is generated.
Click on the CREATE button to save the changes.
If the details are incorrect or the server is down, you will get a message “Connection unavailable”.
If you have any feedback on Gathr documentation, please email us!