Document toolboxDocument toolbox

This article is for Timesheets for Cloud. Visit Data Center

Connecting to Google Calendar for Your Organization

You can connect your Tempo user accounts with their Google Calendar accounts after you install Google Calendar for your organization. When integrated for an organization, individuals don’t need to perform any extra steps to reap the benefit of connecting to Google Calendar. They can see all of their scheduled meetings and other events in My Work, log time by clicking on the calendar event cards, and view their calendar events in their Activity Feed without integrating with Google Calendar manually.

For more information about day-to-day usage, see Google Calendar for Tempo Timesheets.

To integrate for your organization:

  1. Create a Google service account for your workspace that can read your users' calendars, profiles, and email and generate a private key for the account.

  2. Install the Google Calendar App in Tempo.

Before You Begin

  • Your Google account must be able to enable SDKs in a project and create a privileged Google service account using the Google Cloud Console. You might also need the permissions to create a project.

  • You need the Tempo Administrator permission to connect Tempo user accounts to their Google Calendar.

Create a Google Service Account and Generate Private Keys

The Tempo app must be able to collect information from users' calendar events and have enough information to associate the Google Workspace account with the correct Tempo account.

  1. Create a new Google Cloud project or use an existing one, and then enable the following APIs:

    • Google Workspace Admin SDK API

    • Google Calendar API

  2. Add a Google service account to the project.

  3. Download the service account private key.
    Note when your key expires, and set a reminder to generate a new set of keys to upload.

  4. Delegate domain-wide authority to the service account with the following OAuth scopes:

    https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/userinfo.email

Private Key Expiration

When your private key expires, the calendar connection you create between your Tempo users and their Google Calendars fails and disconnects. Meetings and events are no longer included in the Activity Feed, so you can’t create worklogs from the activity cards.

Users who have connected to their Google Calendar on the Individual level are not affected.

Install the Google Calendar App for your Organization

  1. As a Tempo administrator, select Apps in the Tempo sidebar.

  2. On the Google Calendar tile, click Install. The Calendar connection page opens.
    If you have already installed the Google Calendar app, click the tile.

  3. Select Organization.

    gcal-org-privatekey.jpg
  4. Upload the private key for the Google service account created to collect information from your users' calendar events.
    If you need to change the service account or update the private key, you can upload a different private key. For example, you can upload a new private key when the previous key expires.

After the service account is successfully authenticated, you can connect Tempo with specific users’ calendars in Manage Staff.

For more information, see Connecting Apps to User Accounts.

When Google Calendar is connected for the organization, individual users will not receive a confirmation as they do when connecting themselves.

Learn More