Introduction

TDM offers the ability to add external data sources. With these data sources TDM offers the ability to display real-time information within your presentation. TDM offers support for the following external data sources:

- Facebook
- Twitter
- Instagram
- Open Weather
- Office365 Calendar
- Google Calendar
- Flickr
- Yammer
- LinkedIn
- Exchange
- Power BI
- NS
- Axis (People Counter camera)
- HIKVision (People Counter camera)

This guide will explain how the Google Calendar data source can be setup.

Requirements

If you want to setup a Google Calendar data source you need to meet the following requirements:

Have administrator access to the TDM designer
Have administrator access to the Google Cloud Platform

How To setup a Google Calendar data source

How to create the 0Auth2.0 credentials:

The first step is to create a Client ID and Secret. To do this go to: https://console.developers.google.com/flows/enableapi?apiid=calendar
Click ‘Create Project’, provide a project name and click the blue ‘Create’ button.
To enable access to the API, click the ‘Next’ button and click ‘Enable’ in the next screen.
Before creating the client credentials, you need to configure an ‘OAuth consent screen’. To do so, select ‘APIs & Services’ from the navigation menu and click ‘OAuth consent screen’.
A screen will open to configure your OAuth consent screen’. Select ‘External’ for the user type, then click the blue ‘Create’ button.

Please note, when you are a GSuite user, you can select ‘Internal’ for the user type.
In the next screen provide an app name (for example: ‘TDM Digital Signage’) and provide an email address for user support in the ‘App information’ section.

In the section ’App domain’ add the following domain as an authorized domain: ‘tdmsignage.com’ using ‘+ Add Domain’ button. The last step in this screen is to provide an email address for developer contact information. Then click on ‘Save and Continue’.
On the next screen ‘Scopes’, you can continue to the next step by clicking ‘Save and Continue’.
On the next screen, ‘Test users’ you can continue to the next step by clicking ‘Save and Continue’
You are now provided with a summary of the ‘OAuth consent screen’, continue by clicking ‘Back to Dashboard’.
Currently the app has a ‘Testing’ publishing status, publish the app by clicking ‘Publish App’ and confirm to push to production.
Now you can create the Client ID and Secret. Select ‘Credentials’ from the side menu, click ‘+ Create Credentials’ in the top menu and choose ‘OAuth client ID’.
Select ‘Web application’ as the application type, you can edit the default name for the client when desired.
Click ‘+ Add URI’ at ‘Authorized redirect URIs’ in the section below. Enter the following URL: https://designer.tdmsignage.com/4.4/authenticate and click the blue ‘Create’ button.

Please note the value ‘4.4’ will change when you upgrade your TDM platform, this means that with a future version the value ‘4.4’ will change to 4.5, 4.6, 5.0 etc. and this URL needs to be added as well.
A pop-up will show with your Client ID and Secret, save this information and continue with the next step in this manual.

Note that when this pop-up is closed, you can always retrieve the Client ID and Secret by clicking the newly created client entry from the list.

How to create the Google Calendar data source:

Please login to the designer with an administrator account: https://designer.tdmsignage.com
Select ‘Config Panel’.
Select the tab called ‘External Data’.
Select the ‘+’ button on the right side to create a new data source.
In the pop-up which will open you can fill in a name for your data source and then select the ‘Google Calendar’ data source. Once selected, click ‘Next’.
In the next window you need to enter your ‘Client ID’ and ‘Client Secret’, select ‘Save’.

Now you have successfully created a Google Calendar data source, it is possible to preview the information of the data source with the ‘eye’ icon in front of the data source.