From 80a194e45c06b3659850fdcef35348c08892dd89 Mon Sep 17 00:00:00 2001 From: David Kendall Date: Mon, 26 Jul 2021 09:04:20 +0100 Subject: [PATCH] Feat/calendar google docs (#18605) --- source/_integrations/calendar.google.markdown | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/source/_integrations/calendar.google.markdown b/source/_integrations/calendar.google.markdown index 9e3a9eb2884..f6beaf1180f 100644 --- a/source/_integrations/calendar.google.markdown +++ b/source/_integrations/calendar.google.markdown @@ -74,9 +74,16 @@ track_new_calendar: required: false type: boolean default: true +calendar_access: + description: > + Determines the level of access that Home Assistant will request when + connecting to calendars. This can be `read_only` or `read_write`. + required: false + type: string + default: read_write {% endconfiguration %} -The next time you run or restart Home Assistant, you should find a new notification (the little bell icon in the lower-left corner). Click on that notification it will give you a link and an authentication code. Click on that link to open a Google website where you should enter the code found in the notification (**NOTE**: You may get a message telling you that the API has not been verified and you will need to acknowledge that in order to proceed). This will grant your Home Assistant service read-only access to all the Google Calendars that the account you authenticate with can read. +The next time you run or restart Home Assistant, you should find a new notification (the little bell icon in the lower-left corner). Click on that notification it will give you a link and an authentication code. Click on that link to open a Google website where you should enter the code found in the notification (**NOTE**: You may get a message telling you that the API has not been verified and you will need to acknowledge that in order to proceed). This will grant your Home Assistant service `read-only` or `read-write` access (based on configuration) to all the Google Calendars that the account you authenticate with can read. ## Calendar Configuration @@ -188,6 +195,12 @@ entities: You can use the service `google.add_event` to create a new calendar event in a calendar. Calendar id's can be found in the file `google_calendars.yaml`. All dates and times are in your local time, the integration gets your time zone from your `configuration.yaml` file. +
+ +This will only be available if you have given Home Assistant `read-write` access (see `calendar_access`). + +
+ | Service data attribute | Optional | Description | Example | | ---------------------- | -------- | ----------- | --------| | `calendar_id` | no | The id of the calendar you want. | *****@group.calendar.google.com