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 working in an office or 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 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.
Contents
- Requirements
- Setup instructions
- View Offline Meeting data in Insights Dashboards
- Update the Google Calendar Integration configuration
- Learn more
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 the 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
Configure your Google instance
-
Whitelist the ActivTrak App. Before authenticating any of your Google accounts, whitelist the ActivTrak OAuth2 application for Google-related integrations. To do this, log in to the Google Workspace Admin Console and enter the ActivTrak OAuth2 Client ID.
-
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:
737466008456-cpjn7795homre29dmob052o0t4h98o7c.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 ActivTrak 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 verify your identity.
- Successful configuration:
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 who will be responsible for the integration authentication. To create a new Super Admin role, click Directory > Users, as shown in the screenshots below.
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
- Admin SDK API
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:
- A modal window will appear as below. Click Authenticate with Google.
- A window will ask for authentication of your Super Admin user, followed by permissions. Click Continue:
- After authentication, in the modal, enter your calendar domain name, as shown above. Your calendar domain should be the organization's primary domain name. Click Finish.
The initial data retrieval may take up to 24 hours to complete. 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 still see 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 must 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.