ActivTrak’s Google Calendar integration (currently available in Early Access) 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:
- 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
- A current ActivTrak Premium or Professional plan subscription
- At least 1 deployed ActivTrak Agent that has started 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
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 G-Suite admin interface 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 G-Suite Admin Console.
- Navigate to Security > API Permissions.
- Ensure API access is enabled for the app you are working with. For Google BigQuery users, make sure Cloud Platform is enabled.
- Click on the Trusted Apps link at the bottom of the app list.
- Click the yellow “+” icon to add a Trusted App, as shown below.
- Select 'Web Application' as the app type and enter the following Client ID:
2. Establish a Super Admin
- From the Google Workspace Admin console, create a new user with a Super Admin role. Alternatively, designate an existing user with a Super Admin role to enable ActivTrak’s Google Calendar integration.
- To create a new Super Admin role, click Users > Super Admin, 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, look up APIs & Services, as shown below.
- Click on Enable APIs and Services, as shown below.
- Enable the following APIs:
- 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 Meeting Insights card, then click the green “Integrate” button within the card, as shown below.
- Click New authentication, then provide a label for your integration instance and enter your Google credentials.
- Click Next, then enter your calendar domain.
- Click Finish.
- Once finished, 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 firstname.lastname@example.org 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.
Was this article helpful?
0 out of 0 found this helpful