Google

The Google connector supports Google products which have APIs with the root URL googleapis.com, these include:

• Google Drive
• Calendar

​

What’s Supported

​

Supported Actions

This connector supports:

• Proxy Actions, using the base URL https://www.googleapis.com.

​

Before You Get Started

To integrate Google with Ampersand, you will need a Google Cloud account.

Once your account is created, you’ll need to create a Google app, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:

• Client ID
• Client Secret
• Scopes

You will then use these credentials to connect your application to Ampersand.

​

Create a Google Cloud Account

You can sign up for a free Google Cloud account here.

​

Enable the appropriate APIs

Go to the API Library page of Google Cloud Console and search for the APIs your integration will need. For example, if you are building a Google Drive integration, type “Google Drive”, select the right API and click the “Enable” button.

Repeat this process for all the APIs your integration will need.

​

Creating a Google App

Follow the steps below to create a Google App:

1. Go to the OAuth consent screen page, pick “External” as the User Type.

2. Enter the information required on the next page, click “Save and Continue”.

Important information about App Logo: when you are creating a Google app for development purposes, do not upload a logo. Uploading a logo will trigger an app verification process. When you are ready to submit your app for review by Google, then you can come back to this page and upload a logo.

3. On the Scopes page, click “Add or Remove Scopes”, and then select the scopes that your integration will need. For example, if you are integrating with Google Drive, type “Google Drive” into the search box and select the scopes you will need. If the scopes you require are not popping up, ensure that you’ve enabled the appropriate APIs (previous step), and then refresh the page.

4. On the Test Users page, click ”+ Add Users” to add up to 100 email addresses, and then click “Save and Continue”.

​

Creating Client ID and Client Secret

1. Once your Google App has been created, go to the Credentials page of Google Cloud Console. Click on “Create Credentials” and then select “OAuth Client ID”.

2. Click “Web Application” from the Application Type dropdown menu.

3. In the name box, write down a descriptive name like “Ampersand Integration”. Under “Authorized redirect URIs”, add https://api.withampersand.com/callbacks/v1/oauth. Click “Create”.

4. There will be a popup which displays the Client ID and Client Secret, you’ll need to add these to the Ampersand Dashboard in the next step. You can either copy and paste these values, or click “Download JSON”.

​

Add Your Google App info to Ampersand

1. Log in to your Ampersand Dashboard.

2. Select the project where you want to create a Google integration.

   

3. Select Provider apps.

4. Select Google from the Provider list.

5. Enter the previously obtained Client ID in the Client ID field and the Client Secret in the Client Secret field. In the Scopes field, enter each of your scopes on a separate line, and prefix each scope with https://www.googleapis.com/auth.

6. Click Save changes.

​

Ship your integration to production

When you are ready to use your integration with external customers, you’ll need to go through the Google App verification process.

1. Go back to the OAuth consent screen page, click on “Edit App” to upload a logo and fill out all the form fields (such as Privacy Page, Terms of Service).
2. After saving your changes, click on the “Publish App” button under “Publishing Status”.

3. Then click on the “Prepare for Verification” button that should now be visible, follow the instructions on the screen.

For more information about the Google verification process, see Google Support docs