Configure Google Calendar and the Google Service Account

In order to configure the Google Calendar™ calendaring app for use with Crestron Fusion® software, the following prerequisites must bemet:

Each room must have its own Google® software account equipped with a calendar and that room must share its Google Calendar with the service account.

NOTE: When a room is reserved for a meeting, it is technically invited the same way a guest or participant would be invited. It therefore requires its own calendar, the same as any guest.

Each user must have a Google account with calendar.
A Google service account must be set up using the Google API.

Activate the Google API

In order for Crestron Fusion to share data with Google Calendar, the Google Calendar API must be activated and configured. The following assumes that a domain with an administrator account, user accounts, and rooms has been set up on the Google Apps web site.

Navigate to code.google.com/apis/console in a web browser.
Using the login fields at the right of the screen, log in as the administrator.

NOTE: If you are using Internet Explorer and reach a blank page after you log in, select Refresh on your browser.

The Google APIs web page defaults to the Overview page, which has the Dashboard on the left and a list active services and their statuses on the right. If the Calendar API is already listed, skip step 4. If it is not listed, select Services on the left.
Locate Calendar API in the Service column and change its status to ON.

Set Up Security

Select API Access on the left.
Select Create an OAuth 2.0 client ID.... The Create Client ID, Branding Information window is displayed.
Fill in the Product Name field and provide a link to your product logo, if desired.
Select Next. The Create Client ID, Client ID Settings window is displayed.
Select the Service Account radio button and then select Create client ID.
When the Public-Private Key Pair Generated window is displayed, copy the password to the clipboard or another accessible location before selecting Download private key.

NOTE: Be sure to store your key in a safe place. There is only one copy and you will need it later in this process.

Once the key is generated and saved, a service account will be created. Record the service account email address, as it will be needed in a future step.

Share Room Accounts with the Service Account

In order for calendar information to be shared, the individual room accounts must be shared with the service account.

NOTE: The Firefox® or Google Chrome® browser must be used for this section of the configuration.

Navigate to the following URL to access the Google Admin Control Panel: "https://www.google.com/a/[your organization].mygbiz.com" (where "[your organization]" is the name of your organization).
Log in to the Google Admin Control Panel.

NOTE: If you reach a blank page after you log in, select Refresh on your browser.

Select Calendar at the menu at the top of the page or in the Your Google Apps section of the page.
Select the gear icon on the upper right of the page, and then select Settings from the drop‑down menu. The Calendar Settings page is displayed.
On the Calendar Settings page, select the Calendars link near the top left. The Calendar Settings, Calendar page is displayed.
Select the Browse interesting calendars link on the lower right side of the page. The Interesting Calendars page is displayed.
Select the More link at the upper left of the page.
Select the Resources for [your organization].mygbiz.com link. The page showing the rooms for your organization is displayed.
Select the Subscribe link for the rooms you wish to link to Crestron Fusion scheduling.
When you have subscribed to all of the desired rooms, select the Manage Calendars link under More Tools on the right side of the page. The My Calendars page is displayed.
Select the Shared: Edit Settings link for the calendar to be shared with Crestron Fusion. The RoomName Details page for the room is displayed.
Enter the Service Account Email Address you saved in Step 7 of Setup Security in the Person list under Share with specific people.
Select Make changes to events from the Permission Settings drop‑down menu.
Select Add Person. The Service Account Email Address will be displayed below the Person list.
Select Save to commit your changes. A pop‑up will open prompting you to confirm your choices. Select OK.
The Invite People pop‑up opens asking if you would like to invite the new room to Google Calendar. Select Don't invite.
Repeat this procedure for additional rooms.

Configure Crestron Fusion to Access the Google Calendar API

Crestron Fusion must be configured to access the Google Calendar API so that schedule data can be shared. Use the following procedures.

Upload the Private Key

Open the Crestron Fusion Configuration Web Client and then select the Configuration tab at the bottom of the tree view on the left.
Select the Scheduling folder to display the Schedule Settings page.
Select the Google Settings tab to expose the fields required for this process.
Enter the Service Account Email Address (refer to step 12 in Share Room Accounts with the Service Account) in the Service Account Name: field.

NOTE: If you are setting this up for the first time, the Currently Loaded Key: field contains no entry.

Select Browse and navigate to the location of the private key file you saved in step 6 of Set Up Security.
When you have located the private key file, select it and then select Open on the browse box.
Select Save on the Schedule Settings page.

NOTE: IIS must be refreshed after changing configuration settings in the Google Settings tab. IIS refresh can be achieved manually if you have administrators access to the Crestron Fusion server. If not, the server should refresh automatically every 24 hours.

Configure One or More Rooms to Use Google Calendar

The room(s) you shared in the Sharing Room Accounts with the Service Account section of this procedure must be set to use Google as its calendar.

Return to the Crestron Fusion Setup Web Client and select the Rooms tab at the bottom of the Tree View.
Select the desired room (or node) and then select Edit if it already exists. If not, select Add Room.
When the Add/Edit Room dialog box opens, select the Scheduling Details tab and then select Google from the Server Access drop‑down menu. The Calendar Email Address field and the Verify Mailbox Setting control appear.
Enter the room's email address in the Calendar Email Address field. This address is found on the room's Details page and uses the form: "GCR0001" <crestron.mygbiz.com_2d34393431313435353731@resource.calendar.google.com> Remove the room name (in this example, GCR0001) and the left and right brackets (< >) before use.
Select Verify Mailbox Setting. A pop‑up will notify you that the mailbox settings were successfully verified or that an error occurred.
If you are creating a new room, fill out the rest of the required fields and tabs. For more information, refer to Add/Edit/Delete a Room.

Test Synchronization Between Calendars.

The following test should be performed to ensure that Google Calendar and Crestron Fusion have been successfully configured.

Open the Google Calendar account for your organization.
Select an available time period and enter descriptive information about the meeting.
Select the calendar of the room that the meeting is to be held in by selecting Rooms, etc. on the right and then selecting Add.
Select Save. A confirmation pop‑up is displayed indicating that the meeting has been successfully added.
Open the Crestron Fusion Monitoring Web Client.
Select the scheduled room in the Tree View at the left.
Select the Schedule tab and navigate to the date and time of the meeting you booked in step 3 above.
Select the meeting and verify the information you entered in the Google Calendar is displayed.
Create a meeting in Crestron Fusion for a time after the Google Calendar meeting ends. Refer to Add Meeting.
Navigate back to Google Calendar and ensure that the meeting you created in the Monitoring Web Client is accurately represented.