README.md

Google Calendar, Task, and Gmail Search and Gmail Notification Device

Hubitat Google Calendar, Task and Gmail Search and Gmail Notification Device

For discussion and more information, visit the Hubitat Community [RELEASE] Google Calendar, Task, and Gmail Search and Gmail Notification Device.

Google API Setup

1. Login to the Google Cloud Console: https://console.cloud.google.com

2. In the left navigation, click APIs & Services, Dashboard, and click Create Project on the right

3. Give your project a name and click Create

   

4. In the left navigation, click OAuth consent screen, Choose External and click Create

5. Set an App name, User support email, and Developer contact information and click Save and Continue

6. On Scopes, Scroll and click Save and Continue

7. On Test Users, Scroll and click Save and Continue

8. On Summary, Scroll and click Back to Dashboard

9. You should be taken back to the OAuth content screen page again, under Publishing status, Click Publish App and Confirm in the popup

10. You may see that your project is in "Needs verification" status, don't worry about that or the warning that it requires verification by Google. Since this project is for your individual use, that process isn't necessary.

11. In the left navigation, click Credentials

12. At the top, click + Create Credentials and choose OAuth client ID

13. Set Application type to Web application, set a Name, set Authorized redirect URIs to https://cloud.hubitat.com/oauth/stateredirect

14. Click Create

15. In the OAuth client created popup, copy the Client ID and Client Secret into your favorite text editor to use in the GCal Search HE app and click OK

16. Next you will enable access to the Google apps you wish Hubitat to search: Google Calendar API, Tasks API, and Gmail API. Feel free to skip a step if you don't intend for Hubitat to search one of these apps.

17. In the top blue search, enter 'calendar api' and choose Google Calendar API under Marketplace, or click here to navigate directly to this API

18. Click Enable

    

19. In the top blue search, enter 'tasks api' and choose Tasks API under Marketplace, or click here to navigate directly to this API

20. Click Enable

21. In the top blue search, enter 'gmail api' and choose Gmail API under Marketplace, or click here to navigate directly to this API

22. Click Enable

23. If you wish to have Gmail Notification Devices please be sure to enable the Gmail API as that is required for this feature.

24. Be sure you have your Client ID and Client Secret handy to continue setup within your HE hub. If you ever need to get them again, you can navigate to APIs & Services and then Credentials to view your OAuth credentials. Clicking the Pencil icon will expose your Client ID and Client Secret.

Hubitat Installation and Setup

Note: Google Calendar Search is available via Hubitat Package Manager (HPM). If you install via HPM, skip to Step 5 below.

1. Back up your hub and save a local copy before proceeding.
2. Install the apps from the "Apps" folder in this repository into the "Apps Code" section of Hubitat. If you are not familiar with this process, follow the steps in How to Install Custom Apps.

• GCal Search - This app requires you to enable OAuth so please follow the instructions mentioned above. Import URL is: https://raw.githubusercontent.com/HubitatCommunity/Google_Calendar_Search/main/Apps/GCal_Search.groovy
• GCal Search Trigger - Import URL is: https://github.com/HubitatCommunity/Google_Calendar_Search/blob/main/Apps/GCal_Search_Trigger.groovy

3. Install the drivers from the "Driver" folder in this repository into the "Drivers Code" section of Hubitat. If you are not familiar with this process, follow the steps in How to Install Custom Drivers.

• GCal Switch - Import URL is: https://raw.githubusercontent.com/HubitatCommunity/Google_Calendar_Search/main/Driver/GCal_Switch.groovy
• Gmail Notification Device - Import URL is: https://raw.githubusercontent.com/HubitatCommunity/Google_Calendar_Search/main/Driver/GCal_Switch.groovy

4. Install an instance of app: go to Apps > Add User App, choose GCal Search
5. Click Google API Authorization
6. Enter the Client ID and Secret copied from Step 15 above
7. Click Authenticate GCal Search
8. Follow the prompts in the popup.
9. When prompted that Google hasn't verified this app, click Advanced
10. In the bottle left click Go to hubitat.com/Hubitat Calendar (or whatever you named your project)
11. Choose which Google Apps to entitle access. This needs to match which APIs you enabled access in the Console. Click Continue

12. Follow the instructions on the final page and close the popup window.
13. Assuming a successful Google Authentication, a message will appear in HE letting you know and to click Next to continue setup.
14. Click Next
15. From here you can setup new Search Triggers by clicking New Search... and follow the instructions.
16. If you have any questions or issues, please post them in the [RELEASE] Google Calendar, Task, and Gmail Search and Gmail Notification Device community thread.