Google Drive

Overview​

The Google drive connector allows you to connect to your GDrive to Graft. You are able to select a target drive and folder as part of the data source configuration.

Connecting to Google Drive is a two step process for the first datasource;

1. Create Datalink
   • we initially create a data link which is based on an individual users credentials (you may want to create a specific user alias for this purpose). This data link will initially sync to show available drives and folders.
2. Create Data source
   • In step two, once this initial sync is completed a Graft user can create a data source based on a Drive and folder(s) combination.

Once the data link has been created and sync'd you are able to create multiple GDrive connectors based on your use case needs by following step 2 of this article

Note: All data within the selected folder's tree will be available to Graft. If you have sensitive data you do not wish to have available to Graft we recommend creating specific folders with only the required data.

 

 Note: Graft will only have access to those folders and documents which are available to the credentials used to create the data link. Where a selected folder has sub folders, the contents of these subfolder IS available to Graft.

 

 

A data source can be created either through the app creation flow or directly from the Data sidebar menu more details can be found the data source overview

 

Prerequisites

The following guide assumes that a project has been created and we have made it to the datasource selection sidebar

 

Google Drive Selection

Click on the See all connectors to display all connectors
Search and click on the required connector icon
Google Drive will now be selected and the CREATE DATA LINK button will be active

Data Link Creation

Click on CREATE DATA LINK this will initiate the link creation flow Click on Continue (having reviewed the End user terms)
Click on Next step (having reviewed the Google API terms and Merge DPA if required)
Select from the available permissions in the drop down. Read and Write is recommended Click Submit
Next we will be stepping into Google's authentication process Click on Open window this will open a separate google login window
Select the google account credentials you would like to use to link to Graft.  Note, Graft uses a third party Merge to provide the interconnect between Google Drive and Graft
Click Continue
Once authentication is complete you will return to the Graft UI and see a success window. Click on Finish Set up
The accepted access permissions will be displayed Click Continue
You have the option to update the integration or check permissions Click Finish
The newly created Datalink will be displayed. For easy identification each data link is given a unique 4 word name
The data link will perform an initial sync, until this is complete Draft will display an error in the preview window. We recommend you click at the top of the screen and return to creating the data source in a few minutes.

Data Source Creation

Once your data link is sync'd from step one, you are able to create your datasource. Return to Data sources and click on CREATE A NEW DATA SOURCE 

Click on the See all connectors to display all connectors Search and click on the required connector icon your newly created datalink will be selected by default, if you have more than one data link you may select another by clicking on the at the end of the datalink field.
From the Drives Field click on the to display available drives and select the one required
Next select the required folders from the dropdown list
Graft will preview data from the new connection for your review Click CREATE to finalize the data source

You may repeat this process to set up different data sources from the same Googledrive datalink as needed.