GCAL bindings - refreshed version

Add-ons Bindings
2

Thank you very much for refreshing this service so people can schedule commands and updates in the future from their Google Calendar, without having to go through IFTTT or CalDAV.

I have some observations using your provided JAR:

  • It’s very convenient to use your Google API credentials for the purpose of testing (in Step 3 above), but users should be informed that this is what they are entering into their openhab.cfg file (just for the sake of disclosure and to understand the potential ramifications).
  • The steps to create one’s own credentials should probably be spelled out in greater detail, as there are some pitfalls along the way. I downloaded the file client_id.json and used the id and secret in that file. Was that correct?
  • I think I did it right because this appeared in the log:
[INFO ] [g.internal.GCalEventDownloader] - ################################################################################################
[INFO ] [g.internal.GCalEventDownloader] - # Google-Integration: U S E R   I N T E R A C T I O N   R E Q U I R E D !!
[INFO ] [g.internal.GCalEventDownloader] - # 1. Open URL 'https://www.google.com/device'
[INFO ] [g.internal.GCalEventDownloader] - # 2. Type provided code ZPWT-UVXXS 
[INFO ] [g.internal.GCalEventDownloader] - # 3. Grant openHAB access to your Google calendar
[INFO ] [g.internal.GCalEventDownloader] - # 4. openHAB will automatically detect the permiossions and complete the authentication process
[INFO ] [g.internal.GCalEventDownloader] - # NOTE: You will only have 1800 mins before openHAB gives up waiting for the access!!!
[INFO ] [g.internal.GCalEventDownloader] - ################################################################################################

I authorized the app against my Google account and I received no warnings or errors in doing so. However, following the instructions in the wiki page, the command was not sent at the intended time (or yet). The only message logged was the one shown above. This test was performed on openHAB 1.8.3 runtime.

I think people’s ability to make use of your excellent contribution will succeed or fail based on the quality of the documentation explaining how to use it. I see the wiki page is very out of date, and seems to describe the current state (before your PR) as essentially unusable. So I don’t see any reason not to update the wiki now, with very clear and complete documentation for how to succeed.