Google Calendar Integration with Simpplr

Application managers, Site owners/managers, and End users can add a Google Calendar tile in addition to the existing Events tile on the Home and Site dashboards. Integrate your Google Calendar to display its events and open its details in Google Calendar directly.

For more information on event syncing, click here.

Security information

When connecting to Google Calendar for the first time, Simpplr will request some OAuth permissions in order for the integration to work. The following table provides definitions of exactly what's being requested from Simpplr. Simpplr will NEVER overwrite any Google Workspace permissions set up, and essentially 'piggybacks' off any existing configuration in Google.

Permission Description Use Features
https://www.googleapis.com/auth/calendar.events View and edit events on all your calendars

Currently used for hitting Google Calendar APIs to fetch the user’s GCal Events and display them on the ‘Events’ page.

In the near future, this will also be used for hitting the APIs for performing 2-Way Event Sync.

  • Get all GCal events for a user

  • 2-Way Event Sync:

    • Get GCal event details

    • Create new GCal events (corresponding to Simpplr events)

    • Update GCal events (only synced events)

    • Delete GCal events (only synced events)

https://www.googleapis.com/auth/calendar.readonly See and download any calendar you can access using your Google Calendar Currently used for hitting Google Calendar APIs to fetch the user’s GCal Calendars in order to display & search through them before adding them to a tile.
  • Get list of all GCal calendars for a user

  • Search through list of all GCal calendars for a user

 

Integrating and connecting

The App manager for your org must first connect Google Calendar at the application level. Group admin permissions for the calendar app are required. To do so:

Go Manage application > Integrations > Calendar integration. Click Sign in with Google.

  • If the Google Drive integration is already enabled, the domain for Google Calendar should match the domain used for your Google Drive.
    Google_calendar_1.gif

     

Note:

If your organization is on the Laki release or later, Simpplr does not require nor ask for the 'manage groups' permission. However, if a user has previously granted Simpplr the manage groups permission (for example, if they were using the pre-Laki, Simpplr-managed permissions configuration), 'manage groups' permission will continue to show in the request. This is because when requesting new permissions, the Google authorization screen will always display all permissions previously granted together with the new requests, so that the user can review them all.

To connect Google Calendar at the user level, navigate to your user profile and select My settings > External apps > Google Calendar > Sign in with Google. All End users as well as Application managers must connect at the user level.Google_calendar_2.gif

Adding events

Depending on App management governance settings, you can add Google Calendar tiles to Home or Site dashboards. To do so:

From the icon at the bottom of the screen, click  Add tile >Add pages, events, albums & blog post tiles > Events.
AWS_google_cal_endar_1.gif

Here you can link your Google Calendar by selecting From Google Calendar. The calendar dropdown can display a maximum of 250 events for you to choose from.

This is how Google Calendar events appear in the Events tile:


google_calendar_2.png

 

Note

If the Simpplr Home dashboard is user-controlled, users will have the ability to add events linked from Google Calendar to their dashboards. Also, if Content type = Events are turned off at the app level, users won't be able to add or see the Google Calendar event tile on their dashboards.

Multi-domain support

As of the Laki release, you can enable multiple domains for your Google Drive and Google Calendar integrations with Simpplr. 

  • App managers can add, view, and delete domains for Google Drive and Calendar.
  • Domains can be managed by going to Manage > Application > Integrations > Domains
  • Upgrading to multi-domain is optional.

If a calendar is shared across multiple domains, it will not be visible to users in Simpplr if they're connected to a different domain than that of the calendar owner/source domain.

When a user from one domain, Jim.Smith@smallcompany.com, shares calendar to a user from another domain, Jane.Doe@bigcompany.com, then the calendars returned from Graph API for Jane.Doe for  will have the result of "owner = null". In Google Calendar, Simpplr does not have a unique calendar ID for a shared calendar across users, therefore we are relying on the owner name and calendar name for shared calendars. Since in cross domain calendars, we get "owner = null" from the API, our shared calendar logic will not be supported in shared calendars across domains.

Set up and add/remove multiple domains

Multi-domain setup depends on whether your Google integration uses Google or Simpplr managed permissions prior to the Laki upgrade. To set up multi-domain:

  1. Go to Manage > Application > Integrations > Domains.
  2. Add the domain names you want.AWS_Google_domains.png

Google managed permissions

To continue setting up with Google managed permissions:

  1. Under the Domains tab, click Add domain name.
  2. Select whether the domain is for Google Drive or Calendar. Enter the applicable domain name.
  3. Click Add domain. Once added, you can remove a domain by clicking x on the right. AWS_google_domains_2.gif

The Google Drive (and if applicable, Google Calendar) domain used prior to the Laki upgrade is added automatically.

Calendar visibility and expected functionality

Shared calendars: When adding a shared calendar to your Simpplr tiles, it should be visible to all users whom it's shared with, unless the calendar got renamed after adding as a tile, or someone's access to it was removed via Google. Note if a calendar is shared across multiple domains, it still will not be visible to users in Simpplr if they're connected to a different domain than that of the calendar owner/source domain.

Personal calendars: The events from a personal calendar, if added as a tile, would be visible to only those who have access from within Google. 

Public calendars and corporate calendars: These are not supported by this integration. 

 

Simpplr managed permissions

To continue setting up with Simpplr managed permissions:

  1. Under Google Drive, you’ll see message stating You’re using a legacy Google Drive integration. Click Find out more.
  2. Upgrading to multi-domain is optional. However, the choice of upgrading or not upgrading is final and cannot be changed. If you’d like to upgrade to multi-domain, click Upgrade
  3. If you clicked Upgrade, choose to keep or remove legacy Google groups. 
  4. Click Upgrade. Multi-domain is now available. 

Keeping legacy groups keeps previously linked folders and groups as they were prior to the upgrade. Removing legacy groups removes all previously linked folders and groups. New users and folders will be added according to your Google permissions. 

 

Note:

The upgrade process takes several minutes. Google Drive and Calendar will be disabled for your app during this time. If you receive an upgrade failed message, please contact Simpplr Support.

Once upgraded, domains can be managed by going to Manage > Application > Integrations > Domains.

Google Workspace Directory data

Multi-domain isn’t yet available for Google Workspace Directory. Regardless of permission type, if Google Workspace Directory was already enabled prior to the Laki upgrade, it will be found under Manage > Application > Integrations > People data. Its domain will be unaffected by the domains added or removed for Google Drive/Calendar.

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.

Articles in this section