Google Workspace integration

ThoughtFarmer's Google Workspace integration allows Google Drive files and folders to be linked and embedded in intranet pages, and allows Google calendars and events to be viewed in ThoughtFarmer. These documents and events can be searched from the intranet using ThoughtFarmer's cloud drive integration features.

To use the Google Drive Card or other Google Workspace integration features such as linking, search and Google calendar events, Google Workspace 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.

Calendar integration

If you have previously set up the Google Workspace integration for cloud drive features, but now wish to enable Google Calendar and event integration, see the following linked areas on this page:

• Additional scopes that must be added
• Enable Google Calendar API
• How to enable the calendar integration in ThoughtFarmer.

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. 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. If you want to use Google Calendar integration, add these additional scopes and Save:

   • https://www.googleapis.com/auth/calendar.readonly
   • https://www.googleapis.com/auth/calendar.events.readonly
10. Select the Credentials tab > Create credentials > OAuth client ID in the pop-up window that appears.
11. For the Application type, choose Web application.
    
    
     
12. Add a Name.
13. Enter the ThoughtFarmer site homepage in the Authorized JavaScript origins and Authorized redirect URLs sections.
14. Click Create.
15. 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 Calendar API

To use Google Calendar integration features:

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

Enable Google Workspace integration

1. On your ThoughtFarmer site, go to Admin panel: Integrations section > Cloud drives and calendars.
2. Under the Google Workspace tab, turn the Google Workspace integration toggle to ON. 
3. In the Google Workspace Client ID box, paste the Client ID Value that you copied when configuring Google APIs in the instructions above. 
4. Enter the Client Secret value you saved from before.
   Authentication type should be Server side tokens. This provides the most security and best user experience.
5. To enable Google Drive integration:
   1. Ensure the Enable cloud drives checkbox is checked.
   2. 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.
   3. 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.)

6. To enable Google Calendar integration:

   1. Select the checkbox Enable Google calendars.
   2. To allow users to search Google calendar events on the intranet, toggle Google calendar search to ON.
      When Google calendar search is enabled, another option appears that controls the maximum number of Google calendar event search results that will appear in the Find-as-you-type search results. To edit the number of results, hover over the box and use the up and down arrows, or click in the box and enter a new number.
   3. Click Login to test the calendar integration.
   4. A screen should open prompting for your Google Workspace credentials. Enter your credentials and complete the login flow. These credentials are used to test the connection and will not be saved or accessible to other users.
   5. If successful, you should see a confirmation message and Google Workspace integration is now enabled.
   6. Important: You must have added the additional scopes specific to the calendar integration and logged in to test the calendar integration before saving the page. If you have added the additional scopes calendar.readonly and calendar.events.readonly you can select the checkbox Yes, calendar permissions have been added.
7. Save the page. If there are any issues, contact the Helpdesk.

Items to note

• Google may take some time to update their servers, so the Google Workspace 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.