Google Drive integration

Google Drive files and folders can be linked and embedded in intranet pages, and searched from the intranet using ThoughtFarmer's Cloud drive integration features. To use the Google Drive Card or other Google Drive integration features such as linking and search, Google Drive integration must first be set up. Follow the instructions below to set it up.

For user instructions on Google Drive integration features, see Cloud drive integrations.

For user instructions on adding the Google Drive Card to a page, see Google Drive Card.

Configure Google Apis to allow access from ThoughtFarmer

1. Sign into your organization's Google account.
2. Go to Google APIs Google Developers Console.
3. If you do not yet have a project for ThoughtFarmer create one.
   • NOTE: A project may have already been created if you are leveraging GSuite authentication and Employee Directory sync.
4. Select the project. Click the OAuth consent screen tab on the left. 
5. Choose Internal for the user type.
6. You need to have at least the following info filled out:
   • App name - For example, the name of your intranet site.
   • Support email - So users know who to contact if they have questions.
   • Developer contact - For Google to contact you about changes to your project.
7. You can also choose to fill out the other fields, such as app logo. Click Save and Continue when done.
8. Click Save and Continue. On the scopes page, add these scopes and save:
   • https://www.googleapis.com/auth/userinfo.profile

   • https://www.googleapis.com/auth/userinfo.email

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

   • https://www.googleapis.com/auth/drive.apps.readonly

9. Select the Credentials tab > Create credentials > OAuth client ID in the pop-up window that appears.
10. For the Application type, choose Web application.
    
    
    
    
11. Add a Name.
12. Enter the ThoughtFarmer site homepage in the Authorized JavaScript origins and Authorized redirect URLs sections.
13. Click Create.
14. Copy the Client ID value and the Client Secret in the pop-up window that appears, and click OK.
    • You can always come back to the credentials screen to get these values

Enable Google Drive API

1. Select the Dashboard tab on the left > Enable APIs and Services.
2. Search for the Google Drive API and enable it.
   
   

Enable Google Drive integration

1. On your ThoughtFarmer site, go to Admin panel > Cloud drives.
2. Under Google Drive, turn on the toggle.
   
   
   
   
3. In the Google Drive Client ID box, paste the Client ID Value that you copied when configuring Google APIs in the instructions above. 
4. Authentication type should be Server side tokens. This provides the most security and best user experience. 
5. Enter the Client Secret value you saved from before.
6. The Reference Name box contains a default name for the Google Drive. This is the name users will see when they access Google Drive integration features on the intranet. If you wish to change the reference name, click the pencil icon.
7. If you want to allow users to search Google Drive from the intranet, turn on the Google Drive search toggle.
   
   
   
   
   • When Google Drive search is ON, another option appears that controls the maximum number of Google Drive search results that will appear in the Find-as-you-type search results. To edit the number of results, click the pencil icon. (To learn more about cloud drive search, see Search cloud drives.)
8. Save all the changes and Google Drive integration is now enabled.

Items to note

• Google may take some time to update their servers, so the Google Drive integration may not work immediately.
• When logging in, users will see the security warning, shown below. To log in, users need to click Advanced > Go to [Google App name] (unsafe). Google has instructions for removing this warning.