Kalender
Termine und Einladungen.
Kalender-Tools
| Tool | Was es tut |
|---|---|
| listCalendarEvents | Jedes Vorkommen zwischen zwei Zeitpunkten, ein sich wiederholender Termin einmal für jedes Mal, mit Ort, Status und Ihrer Antwort. |
| getCalendarEvent | Ein Termin vollständig, über id oder über die threadId der Unterhaltung, die seine Einladung trägt: die Teilnehmer und ihre Antworten, wie er sich wiederholt und seine Erinnerungen. |
| createCalendarEvent | Einen Termin in den Kalender eintragen und die Teilnehmer von einer Adresse einladen, von der Sie senden dürfen. Im Chat der App fragt es zuerst, außer Sie haben darum gebeten. |
| updateCalendarEvent | Einen Termin ändern, den Sie organisieren, und die Aktualisierung an alle Eingeladenen senden. Im Chat der App fragt es zuerst, außer Sie haben darum gebeten. |
| cancelCalendarEvent | Eine Besprechung absagen, die Sie organisieren, und alle Eingeladenen benachrichtigen. Im Chat der App fragt es immer zuerst. |
| deleteCalendarEvent | Einen Termin aus dem Kalender nehmen, ohne jemandem Bescheid zu geben. Im Chat der App fragt es immer zuerst. |
| respondToCalendarEvent | Eine Einladung annehmen, ablehnen oder vorläufig annehmen und es dem Organisator mitteilen. Im Chat der App fragt es zuerst, außer Sie haben darum gebeten. |
Lesen erfordert calendar:read und jede Änderung calendar:write. Alles, was jemandem eine E-Mail schickt, erfordert auch emails:send: Einladungen, Aktualisierungen oder Absagen einer Besprechung mit Teilnehmern und jede Antwort auf eine Einladung.
Ein auf einige Adressen beschränkter Client sieht und ändert nur die Termine, die eine davon organisiert oder an denen sie teilnimmt, und sendet nur von ihnen.
Referenz
listCalendarEvents
The calendar between two moments, as the Calendar page of the app shows it: every occurrence in the window, a repeating event once for each time it happens, sorted by start, with its event id, place, status and your answer. from and to are ISO 8601 with a zone, at most a year apart, and timezone (an IANA zone, UTC unless you say) decides what an all-day event means. When more follow, the last line gives the offset to pass back.
Eingaben
fromstringErforderlich- Format
date-time tostringErforderlich- Format
date-time timezonestring- 1 bis 64 Zeichen
limitinteger- Mindestens 1Höchstens 200
offsetinteger- Mindestens 0
Auch verfügbar über
getCalendarEvent
One calendar event in full: when it is, where, who organised it, every attendee and their answer, your own answer, how it repeats and its reminders. Pass id for an event from listCalendarEvents, or threadId for the invitation a conversation carries.
Eingaben
idstring- 1 bis 64 Zeichen
threadIdstring- 1 bis 256 Zeichen
Auch verfügbar über
createCalendarEvent
Put an event on the calendar, as New event on the Calendar page does. start and end are ISO 8601 with a zone. With attendees, an invitation goes to each of them from the address in from, which has to be one you may send as, unless sendInvites is false. reminders takes minutes before the start, and recurrence an RRULE such as FREQ=WEEKLY;BYDAY=MO.
Eingaben
summarystringErforderlich- 1 bis 255 Zeichen
startstringErforderlich- Format
date-time endstringErforderlich- Format
date-time descriptionstring- Bis zu 8000 Zeichen
locationstring- Bis zu 255 Zeichen
urlstring- Bis zu 2000 ZeichenFormat
uri allDaybooleantimezonestring- 1 bis 64 Zeichen
recurrencestring- Bis zu 512 Zeichen
attendeesobject[]- Bis zu 200 Einträge
emailstringErforderlich- Bis zu 320 ZeichenFormat
email namestring- Bis zu 128 Zeichen
optionalboolean
remindersobject[]- Bis zu 5 Einträge
minutesBeforeintegerErforderlich- Mindestens 0Höchstens 40320
sendInvitesbooleanfromstring- Bis zu 320 Zeichen
Auch verfügbar über
updateCalendarEvent
Change an event you organise: its title, time, place, attendees, reminders or repeating. A field left out keeps its value, and attendees replaces the whole list. Everyone invited gets the updated invitation unless sendInvites is false.
Eingaben
idstringErforderlich- 1 bis 64 Zeichen
summarystring- 1 bis 255 Zeichen
startstring- Format
date-time endstring- Format
date-time descriptionstring- Bis zu 8000 Zeichen
locationstring- Bis zu 255 Zeichen
urlstring- Bis zu 2000 ZeichenFormat
uri allDaybooleantimezonestring- 1 bis 64 Zeichen
recurrencestring- Bis zu 512 Zeichen
attendeesobject[]- Bis zu 200 Einträge
emailstringErforderlich- Bis zu 320 ZeichenFormat
email namestring- Bis zu 128 Zeichen
optionalboolean
remindersobject[]- Bis zu 5 Einträge
minutesBeforeintegerErforderlich- Mindestens 0Höchstens 40320
sendInvitesbooleanfromstring- Bis zu 320 Zeichen
Auch verfügbar über
cancelCalendarEvent
Call off a meeting you organise, as Cancel meeting does in the app: it stays on the calendar marked cancelled, and everyone invited is told it is off, from the address in from. A chat always asks first.
Eingaben
idstringErforderlich- 1 bis 64 Zeichen
fromstring- Bis zu 320 Zeichen
Auch verfügbar über
deleteCalendarEvent
Remove an event from the calendar for good, as Remove does in the app. Nobody else is told, so call off a meeting with others in it with cancelCalendarEvent instead. A chat always asks first.
Eingaben
idstringErforderlich- 1 bis 64 Zeichen
Auch verfügbar über
respondToCalendarEvent
Answer an invitation: ACCEPTED, DECLINED or TENTATIVE. The answer goes to the organiser by email from the invited address you may send as, or from respondingAs when the invitation went to more than one of yours.
Eingaben
idstringErforderlich- 1 bis 64 Zeichen
responsestringErforderlich- Einer von
"ACCEPTED""DECLINED""TENTATIVE" respondingAsstring- Bis zu 320 Zeichen