Cubu Docs
Technical Guide
Technical Guide
  • Welcome to Cubu's Technical Guide!
  • White Papers
    • Data Protection
    • Sign On and Authentication
  • Advanced Configuration
    • Configuring Video Meetings
      • ⚒️Using Microsoft Teams for Video Meetings
      • ⚒️Using Zoom for Online Meetings
    • Calendar Integration
      • ⚒️Configuring Microsoft Office 365 Calendar Integration
      • ⚒️Configuring Google Workspace Calendar Integration
    • Configuring Single Sign On (SSO)
      • ⚒️Configuring SSO with Azure AD
      • ⚒️Configuring SSO with Okta
      • ⚒️Configuring SSO with Auth0
    • Configuring Chatbots
      • Configure Chatbot using WhatsApp
  • Webhooks
    • Webhooks Configuration
    • Developing Webhooks
      • Dev Tools
      • HMAC Validation (ASP.NET Core)
    • Webhooks Reference
      • Organization Webhooks
        • 🪝Webhook: Send SMS
      • Data Table Webhooks
        • 🪝Webhook: Query
        • 🪝Webhook: Find
        • 🪝Webhook: Fetch
      • Service Webhooks
        • 🪝After Book Appointment
        • 🪝After Check In
        • 🪝After Close
        • 🪝Before Book Appointment
        • 🪝Before Check In
        • 🪝Before Queue-Up
        • 🪝Before Resolve
        • 🪝After Queue-up
        • 🪝After Resolve
        • 🪝After Start Work
      • Kiosk Webhooks
        • 🪝Before Query Appointments
  • Server to Server (S2S) API
    • Server to Server (S2S) API
Powered by GitBook
On this page
  • Overview
  • Google Cloud Platform Configuration
  • Google Workspace Configuration
  • Cubu Configuration
  • Troubleshooting Integration Issues
  1. Advanced Configuration
  2. Calendar Integration

Configuring Google Workspace Calendar Integration

PreviousConfiguring Microsoft Office 365 Calendar IntegrationNextConfiguring Single Sign On (SSO)

Last updated 1 year ago

Google Calendar integration is supported for Google Workspace accounts. This feature is not supported when using individual Google accounts.

Following the instructions in this document requires admin access to the organization’s Google Workspace.

Overview

For Cubu to access the Google Workspace Calendars of users in your organization, you must provide Cubu with the proper credentials.

The process consists of the following steps:

  1. Enabling Google Calendar API and creating a service account with API credentials on Google Cloud Platform (GCP).

  2. Authorizing the service account to access users' data in your Google Workspace.

  3. Configuring Cubu calendars integration.

Google Cloud Platform Configuration

  1. Set up a Google Cloud Platform Project:

    • Go to the .

    • Create a new project or select an existing one.

  2. Enable the Google Calendar API:

    • In the Google Cloud Console, go to the Library and search for "Google Calendar API."

    • Click on the result and enable the API for your project.

  3. Create API Credentials:

    • In the Google Cloud Console, navigate to "APIs & Services" > "Credentials."

    • Click "Create credentials" and choose "Service accounts".

    • Click on “CREATE SERVICE ACCOUNT”

    • Name the service account and set the service account ID.

    • Complete the steps (using defaults) to create the account.

  4. Creating a private key for the service account

    • From the Credentials section, click on the service account you have just created.

    • Go to the KEYS tab and click on ADD KEY

    • Choose JSON and click CREATE. This will download a JSON credentials file to your computer.

The JSON file contains sensitive information that provides access to your Google Workspace. Keep it in a safe place.

At the end of this process, your Google Calendar API should look similar to this:

Google Workspace Configuration

Delegating domain-wide authority to the service account

In this step, you will authorize the service account created in the previous section to access Workspace user data on behalf of users in the Google Workspace domain.

  1. Go to Security > Access and data control > API controls

  2. Click on MANAGE DOMAIN WIDE DELEGATION

  3. Enter https://www.googleapis.com/auth/calendar as the OAuth scope.

Cubu Configuration

  • In Cubu, go to Admin Tools > Settings > Integration.

  • Choose the Calendars tab.

  • Select Google Workspace as the provider.

  • Copy the service account email (client_email) and private key (private_key) values from the JSON credentials file.

  • Tick the Enable external calendars integration check box.

  • Click on Save

Troubleshooting Integration Issues

Check the Event Log (Admin tools > Logs > Event log) if events are not created in the remote calendar.

If you get a message similar to this:

User: user@email.com PKCS8 data must be contained within '-----BEGIN PRIVATE KEY-----' and '-----END PRIVATE KEY-----'. (Parameter 'pkcs8PrivateKey')

Try removing linebreaks () from the private key.

Go to .

In the Client ID text box, enter the client_id value from the JSON credentials file you have downloaded.

⚒️
Google Workspace Admin Console
Google Cloud Console