Google Cloud Storage Integration

Overview

The Google Cloud Storage integration allows you to use Google Cloud as a source for importing and exporting data into and out of your Cordial account using either the user interface (UI) or the API.

Once the integration is successfully configured, you will see a new option for Google Cloud Storage on data import and export pages within the UI, and as a source or destination parameter in the API.

Configure Cordial to access your GCS buckets

There are two ways to set up Cordial to access your GCS buckets: key file and service account.

Key file authentication requires a client to create a service account in client's GCP account, give the service account access to the buckets, download JSON key file and upload it to Cordial.

Service account authentication automatically creates a service account in Cordial Google Cloud Platform account, then you give access to this service account to your buckets. Service account authentication is easier to set up and is more secure because the key is never shared with Cordial. 

Each authentication method allows to configure access to multiple buckets. Each bucket can have its own authentication method type.

Key file authentication

Before you are able to enable the integration, you must first create a Google Service Account in your Google Cloud Platform.

In your admin panel, navigate to Service accounts, give the account a name and an ID and click Create.

Define a Role for your service account.

Create and download a JSON key.

Confirm the key has the admin rights to the bucket.

Once you have created a service account and downloaded the key in JSON format, you can enable the integration in the Cordial Marketplace.

Navigate to the Marketplace, located in the account management dropdown.

On the Marketplace page find the Google Cloud integration card.

Click Enable to edit the configuration. You will see a list of configuration settings to complete in order to enable the integration.

• Bucket Name - Enter the name of your Google Cloud Bucket.
• Bucket Description - Give a brief description of the Google Cloud Bucket.
• Upload Key File - Upload the key file downloaded from your Google Cloud Storage account.

Service account authentication

To start using service account authentication, first you need to create a service account. To do this navigate to the marketplace card, select Service Account authentication for any bucket and click Create Service Account button at the bottom of the card:

This will create a separate service account in Cordial Google Cloud Platform account. This service account is linked to your account in Cordial. After it is created, the email of the service account will be displayed in the marketplace card:

Add this service account with the Storage Admin role to each bucket that Cordial needs to have access to:

Using Google Cloud Storage

Once the Google Cloud Storage is set up successfully there will be options to use Google Cloud when importing and exporting contacts via the UI as well as the API.

Import Via the UI

When importing contacts in the UI, there will be an option for Google Cloud as an input source. In the Path field specify the file name in the bucket, for example folder/contacts.csv

Export Via the UI

When exporting contacts in the UI, there will be an option to Send file to Google Cloud as an export destination. In the Path field specify the name of the folder to export contacts to, for example, folder/subfolder. After the export is complete, the folder will contain the file with the exported contacts. The name of the file will be [ExportName].csv

Via the API

Once enabled, Google Cloud will be a source option for importing and exporting contacts using the API. View the API documentation for importing or exporting contacts.