Configuring the Google Workspace integration

In order to integrate TeamTrax with Google Workspace (former G Suite), you need to provide service account credentials on the configuration page. These include a generated email address that is unique and a public/private key pair. For TeamTrax to be able create events on behalf of your users, you need to enable domain-wide delegation as well and provide the generated client ID.

Create a Service Account

To generate service-account credentials, or to view the public credentials that you've already generated, do the following:

  1. Open the Service accounts page.
  2. If prompted, select a project, or create a new one.
  3. Click + Create service account.
  4. Under Service account details, type a name, ID, and description for the service account, then click Create.
  5. Optional: Under Service account permissions, select the IAM roles to grant to the service account, then click Continue.
  6. Optional: Under Grant users access to this service account, add the users or groups that are allowed to use and manage the service account.
  7. Click + Create key (JSON), then click Create.
  8. Download the generated private key file.

You can leave the optional items (5, 6) blank.

Enable Domain-wide Delegation

To enable domain-wide delegation:

  1. From the Admin console, go to Main menu > Security > API Controls.
  2. In the Domain wide delegation pane, select Manage Domain Wide Delegation.
  3. Click Add new.
  4. In the Client ID field, enter the service account's Client ID (You can find your service account's client ID in the Service accounts page - see above).
  5. In the OAuth scopes field, enter the list of scopes separated by comma that your application should be granted access to. For example, if your application needs domain-wide full access to the Google Drive API and the Google Calendar API, enter: https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/calendar.
  6. Click Authorize.

To be able to save your domain-wide configuration, you have to enter a product name or the save button will not be enabled.

TeamTrax only needs the https://www.googleapis.com/auth/calendar scope to work.

Enable Calendar API

Make sure Calendar API is enabled by going to the following address: https://console.developers.google.com/apis/api/calendar-json.googleapis.com/overview