ActivTrak’s Google Calendar integration enables a more comprehensive picture of employees’ workdays, filling in the “blank spaces” in users’ digital activity with meeting data from their calendars.

Many employees — especially those who work in an office or who are frequently in the field — do not spend their entire workday in front of a computer. Much of their time is spent in in-person or in phone meetings that can’t be detected by the ActivTrak Agent. During periods of digital inactivity, the Google Calendar integration provides an additional data source, enabling ActivTrak to fill in the gaps with time spent in Offline Meetings.

Setting up the Google Calendar integration involves configuring your Google instance to establish a super admin, whitelisting the OAuth2 application used by ActivTrak for Google-related integrations and enabling ActivTrak APIs. Once the setup process is complete, the integration can be configured within the ActivTrak app.

Follow this guide for step-by-step instructions:

• Requirements
• Setup Instructions: Configure Your Google Instance
• Setup Instructions: Establish a Super Admin
• Setup Instructions: Enable the ActivTrak APIs for the Google Calendar Integration
• Setup Instructions: Configure the Google Calendar Integration in ActivTrak
• View Offline Meeting Data in Insights Dashboards
• Update the Google Calendar Integration Configuration

Requirements

• An Admin user role in ActivTrak
• A current paid ActivTrak subscription or an active trial
• At least one deployed ActivTrak Agent starting to collect activity data
• An active Google Cloud instance
• An active project setup within Google Cloud Platform
• Super administrator permissions to your active Google Workspace instance
  • Super admin is required for domain-wide access to all users’ calendar data

Setup Instructions

1. Configure Your Google Instance

• Whitelist the Tray.io App. Before authenticating any of your Google accounts, whitelist the Tray.io OAuth2 application which is used by ActivTrak for Google-related integrations. To do this, log in to the Google Workspace Admin Console and enter the Tray.io OAuth2 Client ID. NOTE: This step does not give ActivTrak access to your Google accounts and applications, it only allows authentications facilitated by Tray.io app.

• Log in to the Google Workspace Admin Console:

• Navigate to Security > Access and data control > API controls:

• Click Manage Third-Party App Access within the App access control panel:

• Click Configure new app to add an app:

• A new window will appear with a search field, as shown below. Paste the following Client ID:

597325623219-f23k7dhk377f8bvamo2e6klu1i37tco7.apps.googleusercontent.com

• Select your Scope for ActivTrak to see users, then click Continue, as shown below. NOTE: Most cases should select the 'All in [organization] (all users)' option.
  
  
• Select 'Trusted' when asked what access to give the Tray.IO application. Leave Allowlist for exemption blank, then click Continue:
  
  
• Finally, review your settings and click Finish to confirm, as shown below. You may be prompted for your password once more to confirm identity.
  
  
• Successful configuration:

2. Establish a Super Admin

• Designate an existing user with a Super Admin role to enable ActivTrak’s Google Calendar integration -OR-
• Create a new user with a Super Admin role that would be responsible for the integration authentication. To create a new Super Admin role, click Directory > Users, as shown in the screenshots below.

3. Enable the ActivTrak APIs for the Google Calendar Integration

• Visit the Google Cloud Console.
• Using the search bar, find 'APIs & Services':

• Click Enable APIs and Services:

• If this is your first time creating a project, click Create Project on the right:
  
• Title your project something friendly that you can recognize. A Project ID will automatically generate for you, as shown below. Only edit this if you have specific reasons to do so.
  
• Once your project has been created and selected, search for and enable the following APIs through the Admin API Library:
  
  • Admin SDK API
    
    
  • Google Calendar API
    
    

4. Configure the Google Calendar Integration in ActivTrak

• Log in to the ActivTrak application. Navigate to API & Integrations > Integrate. 
• Locate the Google Calendar Integration card, then click the Integrate button:

• Click New Authentication, then provide a label for your integration instance and enter your Google credentials, as shown below. Click Next.

•  Enter your calendar domain name in the window shown below. Your calendar domain should be the organization's primary domain name. Click Finish.

• A window will ask for authentication of your Super Admin user, followed by permissions. Click Allow:

• Click Finish.
  • It may take up to 24 hours to complete the initial data retrieval. The integration card will temporarily display the message: “Your data is being processed. This may take up to 24 hours to complete.”
  • Once the process is complete, the card will display the message: “✓ Enabled.”
  • If you are still seeing the “Your data is being processed” message after 24 hours, please email support@activtrak.com for assistance.

View Offline Meeting Data in Insights Dashboards

After enabling the Google Calendar Integration, Admins will get access to a set of dashboards that display Offline Meeting data. Learn more here.

Update the Google Calendar Integration Configuration

To update your Google Calendar integration configuration (i.e. to use a different Google credential), the integration will need to be deleted and re-enabled to accept the update. 

To delete the Google Calendar integration, click on the three-dot settings icon in the top right corner and select Delete, as shown below. After deleting, please follow the previous steps in this guide to reconfigure the integration.

Learn more:

• Offline Meetings
• Insights Configuration
• Contact Support