Google Calendar
Win more deals by ensuring important meetings are taking place and your team is well prepared.
Overview
Connecting your team's Google Calendars is an important step in unlocking the power of Opine. Calendar data powers project timelines, deal tracking, and collaboration features within Opine.
How Opine Uses Google Calendar Data
All Google data is used in accordance with our privacy policy.
Opine reads event details (title, description, times, status, recurrence, visibility), attendee lists, organizer/creator information, and event links from users' primary Google Calendars. Only non-private events on primary calendars are accessed, and only for users whose email addresses are known in your CRM and match your Google Workspace hosted domain.
Once you complete configuring the Google Calendar integration, calendar events that have an end date after three months ago and a start date up to the end of next quarter are imported. Only events from the primary calendars of deal collaborators are imported.
Events that are directly marked private are not included in any analysis. Please let us know if your organization uses a default calendar ACL that makes all events private (such as a "busy only" configuration).
Configure
There are two ways to configure the Google Calendar integration, depending on your organization's security requirements and setup:
Domain-wide Delegation (recommended): This allows Opine to act as any user in the organization. It avoids the need for each user to authorize Opine to read their calendar. There are two read only scopes granted to Opine by a Google Workspace super admin, so our abilities are limited.
OAuth Authorization: This allows Opine to act as the single user who authorizes the integration. This may impose limitations on calendar access because we must read other user's calendars as this single user. There are two read only scopes requested in the authorization flow.
Choose the method that best fits your organization's security policies and Google Workspace configuration.
Please note:
Once an Opine organization has connected to a Google Workspace, the hosted domain is now reserved. No other Opine organization can collect calendar events from this domain.
Only calendars for email addresses in the hosted domain are read. It's currently necessary that the Opine user installing the integration has an email address in the domain of the Google Workspace where events related to your CRM deals are managed.
Reach out to [email protected] if you need us to ingest calendars from a domain other than the one associated with your Opine email address.
Option 1: Domain-Wide Delegation (Recommended)
This method provides the most comprehensive calendar access for your organization and relies on a Google Workspace admin to complete installation.
Take these steps to configure the integration.
Verify the Google Workspace domain of calendars used to manage events related to your CRM deals.
Authorize Opine to access your Google Workspace user’s calendars through domain-wide delegation.
Connect the integration in your Opine organization.
Verify Domain
Visit the Google Calendar integration installation page in your Opine organization and ensure Domain-wide Delegation is the selected option. Note the Domain we will be reading calendars from, reflecting the domain of your Opine user email address. This is the Google Workspace domain that must authorize domain-wide delegation to our service account.
Authorize
Authorize Opine to read your Google Workspace user's calendars by granting domain-wide delegation to our Google Service Account (learn more). The Google Workspace administrator making the change in the Google Admin console must be a domain admin.
In the Google Workspace admin panel:
Visit Security → API Controls → Domain-wide Delegation in your Workspace Admin settings
In the list of API Clients, click Add new, or edit the existing client if you've installed our Google Drive integration
The Opine service account Client ID is
114541357281897886665([email protected])The OAuth scopes we use to read calendars and events:
https://www.googleapis.com/auth/calendar.calendars.readonlyhttps://www.googleapis.com/auth/calendar.events.readonly
Click Authorize to grant domain-wide delegation
Connect
Opine does not import calendars until domain-wide delegation has been granted to our service account and the integration has been connected to the Opine organization.
Once domain-wide delegation has been granted, visit the Google Calendar integration installation page in your Opine organization, ensure domain-wide delegation is the selected option, and click Connect.
Option 2: OAuth Authorization
This method relies on consent of a single user and does not require a Google Workspace admin to complete installation.
Important: Choosing this method may limit Opine's ability to read all relevant calendars, particularly in cases where other users have not shared their calendars, or the organization has not configured a default calendar sharing policy.
Authorize to Connect
Visit the Google Calendar integration installation page in your Opine organization
Select Authorize as User
Complete the Google OAuth consent flow by clicking Continue with Google
Grant the necessary calendar permissions when prompted
The OAuth scopes we use to read calendars and events:
https://www.googleapis.com/auth/calendar.calendars.readonlyhttps://www.googleapis.com/auth/calendar.events.readonly
Last updated