Google Drive Integration: Setup Guide

Connect your Google Drive with Showell and sync your selected content.

Allowlist Showell in your Google Workspace

Before you can start using the Showell Google Drive and Google File Editor integrations, you need to add them to your workspace allowlist. This is important because these integrations require read access to the contents on the user's Drive.

For more in-depth information: Manage third-party app access to Google services & add apps

1. Open and login to your Google Workspace with an Administrator Account

2. In the side menu, go to Security > Access and data control > API controls

3. For Configured apps, click Add app.

4. Choose Client ID

5. Enter the following client ID's and click Search:

• showell-gdrive
• showell-gdrive-editor

6. Point to the app and click Select.

7. Check the boxes for the client IDs that you want to configure and click Select.

8. Select who to configure access for:

• By default, the top organizational unit is selected. Leave this selected to set access for all users in your organization.
• To configure access for specific organizational units, click Select org units, then click + to view your organizational units. Check the desired organizational units, then click Select.

9. Click Continue.

10. Choose the option "Trusted": App can access all Google services (both restricted and unrestricted).

11. Review settings for the Showell app, then click Finish.

 

---

Create Dedicated Integration Users (Optional)

💡 This step is particularly advisable for Professional or Enterprise Workspaces that manage a substantial number of users.

Create separate user accounts specifically for the integration. These serve as a bridge between Google Drive and Showell, minimizing interruptions and simplifying access management while preventing accidental file modifications.

Create a Dedicated Integration User in Google Drive

• Example Account Name: Companyname_Admin or showell.sync@yourdomain.com.
• Access Rights: Assign read-only access to ensure the user can only view files and not make changes.
• When authorizing the connection between Showell and Google, Sign in with this User Account

Set Up Access to Shared Drives/Folders

1. Make sure the 'Share with people settings' are setup correctly:

• Editors should be able to change permissions and share
• Viewers and commenters should be able to see the option to download, print and copy

2. Make sure the right Drive/folders are accessible:

1. Go to the Shared Drive or folder.
2. Click “Share” and add the integration user’s name/email.
3. Set the access level to "Viewer" (read-only).

Create a Dedicated Integration User in Showell:

Utilizing a dedicated user account will help ensure that your integration operates seamlessly without any disruptions and remains unaffected by individual user settings.

• Example Account Name: Companyname_Admin or showell.sync@yourdomain.com.
• Access Rights: Assign this user with the Admin role.
• In Showell, sign in with this user account to initiate the authorization process.

 

---

Authorize the connection between Google Drive and Showell

Make sure you have allowlisted Showell in your Google Workspace before authorizing the connection between Google Drive and Showell.

1. Go to Showell Admin

• Login with you dedicated Showell integration user

2. From the top menu, select: Admin > Google Drive

3. Begin authorization by selecting “Authorize by signing in to Google Drive”

• Login/authorize with your dedicated Google integration user

 

---

Create linkages: Sync your content between Google Drive and Showell

Once the connection has been authorized, you can start syncing your content between Google Drive and Showell.

1. Connect your folder

• When connecting your first folder, you can click 'Connect first folder'
• When connecting a folder later on, click 'Connect folder' in the top right corner

2. A pop-up screen will appear to connect your Google Drive folder to Showell

• Use the arrows to navigate your contents
• Left panel: Choose the Google Drive folder you want to connect
• Right panel: Choose the target destination for this folder in your Showell directory

3. Click OK

 

---

Manage your integration

1. Check the status of your linkages by refreshing them. Running linkages can be monitored using this feature to see if they have been completed. This will not fetch new or changed files.

2. To fully remove your Google Drive connection: Click Google Drive > Disable Google Drive

3. By clicking the 'Drop-down menu'-button located on the right side of your connected folder, you are able to:

• Remove connection: This will remove the individual linkage
• Disable connection: The linkage is still connected but will not synchronize
• Fetch new or changed files: This will immediately synchronize the individual linkage