Google Drive Integration

First, go to https://console.developers.google.com/apis/ to begin your project.

You may be redirected to the /projectselector2/ if you need to accept Google Cloud Platform's Terms of Service.

Please read them and agree to Google's Terms of Service in order to proceed.

Once you are in, if you still see the Google Cloud Platform header, you will need to click on Create Project, and give the project a name, like "SideDrawer Integration".

Then you can choose an organization, if you prefer.

If you don't have organizations registered and you want to proceed anyway, simply click CANCEL and go ahead to create your project without setting an organization.

Just click CREATE
​

We need to enable APIs and Services from Google in order to connect this project with the SideDrawer platform.

Please click on + ENABLE APIS AND SERVICES

Once you get to the Google API Library, scroll down until you find the Google Drive API and select it (you can also enter 'Google Drive API' in the search box).

Now you need to ENABLE this API for your project:

Once you have enabled the API, you will be able to see the overview and CREATE CREDENTIALS for this project.

You may have the option to go through the wizard provided by Google to help you choose the right credentials.

No matter how long that list is, find the item that reads Google Drive API from the drop down menu and select it.

When the next question opens up, select the answer that reads Web server...

And choose User data from those two options:

Once you've done all that, Google will instruct you on what type of credentials to use.
Simply click on What credentials do I need? and you'll see the response pop up.

After doing this, please note that Google may give you the option to use existing credentials that you may have used in a previous project.
You can choose to use those or create a new set.

On this step, you will be setting up the consent screen that your SideDrawer Managers will be presented with at the time of setting up the Integration in SideDrawer.
If you have done this before, you will not be asked for any of this and you can move onto the next step.

You are creating an OAuth client ID to enable the connection between SideDrawer and your Google Drive.

You will need to Set up Consent Screen, only if you haven't done this before.
This will allow your SideDrawer Manager understand what he or she is agreeing to at the time of configuring the integration between SideDrawer and Google Drive.

From the User Type list, choose Internal and click CREATE

Enter the App name "SideDrawer" and enter your email address.

Scroll down and enter the following links where requested:

Next, under Authorised domains and Developer contact information, please provide the following:

Once you have finished your "OAuth consent screen" you will be able to create the Scopes of this Application.

You need to click on ADD OR REMOVE SCOPES

A long list of scopes will appear and you will need to find the specific scopes that will allow SideDrawer to interact with your Google Drive.

You can change the number of records per page, or simply scroll until you find the following two scopes:

Select these two and click UPDATE.

Then click SAVE AND CONTINUE.

Now we must create Google credentials for SideDrawer so your account can access content on your Google Drive.

First, under Create OAuth client ID please provide the following:

Next, under Authorized JavaScript origins please provide the following:

Then, under Authorised redirect URIs please provide the following:

To finish this step, click CREATE.

Copy both "Your Client ID" and "Your Client Secret" as you will need them to set up your connection from the SideDrawer Console in Step 12

This concludes the Google Drive part. Now you need to move to the SideDrawer Console to complete your configuration.

Now we need to enter the integration details on the SideDrawer Console to sync your SideDrawer Account with your Google Drive.

Log into your SideDrawer account, and go to Console

Once you are logged in to your Console, on the left side menu click on "Applications" and then "Integrations".

Select Set up a New Integration
​

Click on Integration Type, and select Google Drive from the drop-down menu
​

In the next screen:

At this point your connection almost done, you now need to confirm the permissions and instruct Google Drive to allow SideDrawer to sync your Account.

It's very simple, you click on the context menu of your connection, within the SideDrawer Console and click on Confirm Integration.

This will trigger the consent screen that you created on your Google Account a few steps ago.

Simply confirm the permissions and wait for the SideDrawer message.
At this point, you should receive a "Success" message.

Close this window and check the status on the SideDrawer Dashboard.
If it shows a check on the "Connected" column, you are good to go.

The integration between your SideDrawer Account and your Google Drive is now complete!

From time to time, you may need to reset the connection between Google Drive and SideDrawer.
For security reasons, the connection between platforms sometimes needs to be re-authenticated.
As the owner of a SideDrawer environment and a Google Drive account, you need to re-affirm that both systems have your permission to link to each other.

1. Log into SideDrawer Console
​

2. Select Developers - Integration

3. Click the 3 dots to the right of the Google Drive integration, and select View Integration Details from the pop-up menu

This will bring up the details screen for your Google Drive integration:

4. In a new tab, log into your Google Cloud Console - Google Cloud console
​

5. Select your integration project for SideDrawer

6. Select API & Services -> Credentials

7. Select the OAuth 2.0 Client ID from your initial integration

8. Select Client secrets, then Add secret

9. Disable the old Client secret and copy the new Client secret
​

10. Go back to the tab with the SideDrawer Console
​

11. Replace the old Client secret with the new Client Secret that you just copied
​

​

12. Select Confirm
​

13. Click on the 3 dots at the right, and select Reset Confirmation

14. Select Confirm
​

15. Done! The new Client secret renews your authorization for your SideDrawer account and your Google Drive account to 'talk' to each other

16. Once you've confirmed that the connection is working, go back to your Google Console and delete the old Client secret.
You've already disabled the old Client secret back in step 9, so deleting it is an extra precaution to remove the security risk

​