Overview

This guide will walk you through the steps generate your client credentials within Google Drive and input them into the Merge Dashboard. Please note that generating your own client credentials is not required for the Google Drive integration to work, but rather an optional step to create your own OAuth Application.

The process begins with the Merge customer creating a Google Cloud Project and submitting an application. Below are the steps you need to take in the GoogleCloud Console as well as the Scopes relevant for Merge's File Storage integrations.

Instructions

Step 1: Generate OAuth credentials in Google

1. Create a Google Cloud Project here!

2. In your Dashboard, go to APIs & Services, and click on Credentials.

   

3. Create a Project for the partnership configuration!

   

4. Configure your OAuth Consent Screen with User Type: External and Published.

5. Click +Create Credentials and begin steps to create an OAuth Client ID.

6. Mark the Application type as Web Application.

   

7. Add the Merge Redirect URI as https://app.merge.dev/oauth/callback.

   

8. Click CREATE. You will see a screen that shows the OAuth Client ID and Secret for your account.

Step 2: Set your scopes

1. Under Data Access, you'll need to add scopes. Please include the following scopes based upon the authentication method your end users will select in Merge Link:

   

   1. User account (read-only)

      1. https://www.googleapis.com/auth/drive.readonly

   2. Admin account (read-only)

      1. https://www.googleapis.com/auth/drive.readonly

      2. https://www.googleapis.com/auth/admin.directory.group.readonly

   3. Admin account (read and write)

      1. https://www.googleapis.com/auth/drive

      2. https://www.googleapis.com/auth/admin.directory.group.readonly

   4. Super admin

      1. https://www.googleapis.com/auth/admin.directory.user.alias

      2. https://www.googleapis.com/auth/admin.directory.group.readonly

      3. https://www.googleapis.com/auth/drive

      4. https://www.googleapis.com/auth/drive.readonly

      5. For Super admin, you'll also need to follow this guide to create your Service Account and Super Admin User.

2. Once the scopes are set, fill out any other required questions about your product and submit your application.

Step 3: Add your Google Drive client credentials to Merge

1. On the Merge Dashboard, navigate to the Integrations tab.

2. Under File Storage, identify the Google Drive integration.

3. Enable the integration using the toggle on the right.

   

4. Click Edit.

5. Select My Credentials.

   

6. Enter the following information in the corresponding fields

   • OAuth Client Id: OAuth Client ID

   • OAuth Client Secret: OAuth Secret

   • OAuth Redirect URI: https://app.merge.dev/oauth/callback

   

Notes:

• Please confirm that the Admin SDK API is enabled. This can be found in APIs & Services --> Enabled APIs & Services

• In your Google Admin account (admin.google.com),

  • Go to API Access Control and the Settings section,

  • Ensure the "(Default) Allow users to access any third-party apps" option is selected.

  • From there you should see the Merge app show up under the "Accessed Apps" list

• Please confirm you have Admin access

• Please confirm your OAuth Consent Screen is "Published" and "External" user type

• Please reach out to your CSM or [email protected] if you have any further questions about the application process