Google Calendar Integration Overview

minware can integrate with Google Calendar as a source of calendar data. This integration is not required for minware, but will provide the following benefits:

  • Ability to see meetings and out-of-office time in development reports to tell how people are spending their time when they are not writing code
  • Enhanced dev days computation accuracy for commits (we will be able to more accurately tell when people are or are not writing code because we can see their meeting schedule)
  • Improved accuracy of email de-duplication in other data sources (e.g., people sometimes make Git commits using their personal email address, and Google directory contains personal back-up emails for each user to link these to work emails)
  • Improved accuracy of canonical name selection (we will know the best name to use for each person rather than picking the most commonly used name from Git commits, which may be incorrect)
  • (If you have configured org units in Google Workspace) Ability to import team information for each person to display in minware (though teams can also be sourced from Github or Jira) Once access has been granted, data ingestion typically takes 48 hours, but may vary depending on the amount of data.

Integration Instructions

You will need to have super-admin privileges in Google Workspace to perform this step.

  1. Navigate to Google Admin.
  2. In the left-side menu, navigate to Security > Access and data control > API controls.
  3. In the bottom-right, click on “MANAGE DOMAIN WIDE DELEGATION”, which takes you to this screen.
  4. On this screen, click “Add new”
  5. Enter the following information in the window that pops up:
  6. Client ID: 114128134261596611610
  7. OAuth scopes (comma-delimited): https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/calendar.readonly
  8. Then, click “AUTHORIZE”

Finally, you must contact support@minware.com to enable this integration, and provide the following information:

  1. The domain(s) associated with your account from which you would like to load users
  2. If you would like to only import events for a subset of users by Org Unit, please specify the Org Unit (e.g., /Employees/Engineering)
  3. The primary email address of an account that has admin privileges to list the directory of users (e.g., the account you used to add access in the previous step)