jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-06-06 18:26:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add docs for new google service (#9057)

Browse Source 
* Update google documention with new service

https://github.com/home-assistant/home-assistant/pull/22473

* ✏️ Tweaks
This commit is contained in:
Isabella Gross Alström 2019-06-18 02:00:48 +02:00 committed by Franck Nijhof
parent fadf8456de
commit c69f3808b1
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
source/_components/calendar.google.markdown
View File

@ -20,6 +20,7 @@ The sensors created can trigger based on any event on the calendar or only for
matching events. When you first setup this component it will generate a new
configuration file `google_calendars.yaml` that will contain information about
all of the calendars you can see.
It also exposes a service to add an event to one of your Google Calendars.
## {% linkable_title Prerequisites %}
@ -174,6 +175,25 @@ Otherwise everything following the hash sign would be considered a YAML comment.
- **start_time**: Start time of event.
- **end_time**: End time of event.
### {% linkable_title Service `google.add_event` %}
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 component gets your time zone from your `configuration.yaml` file.
| Service data attribute | Optional | Description | Example |
| ---------------------- | -------- | ----------- | --------|
| `calendar_id` | no | The id of the calendar you want. | Your email
| `summary` | no | Acts as the title of the event. | Bowling
| `description` | yes | The description of the event. | Birthday bowling
| `start_date_time` | yes | The date and time the event should start. | 2019-03-10 20:00:00
| `end_date_time` | yes | The date and time the event should end. | 2019-03-10 23:00:00
| `start_date` | yes | The date the whole day event should start. | 2019-03-10
| `end_date` | yes | The date the whole day event should end. | 2019-03-11
| `in` | yes | Days or weeks that you want to create the event in. | "days": 2
<p class='note'>
You either use `start_date_time` and `end_date_time`, or `start_date` and `end_date`, or `in`.
</p>
## {% linkable_title Using calendar in automations %}
A calendar can be used as an external scheduler for special events or reoccurring events instead of hardcoding them in automations.