캘린더
일정과 초대.
캘린더 도구
| 도구 | 하는 일 |
|---|---|
| listCalendarEvents | 두 시점 사이의 모든 회차. 반복 일정은 회차마다 한 번씩 나오며, 장소, 상태, 내 응답이 함께 나옵니다. |
| getCalendarEvent | 일정 하나의 전체. id로, 또는 초대가 담긴 대화의 threadId로 지정합니다. 참석자와 그 응답, 반복 방식, 알림이 포함됩니다. |
| createCalendarEvent | 일정을 캘린더에 넣고, 보낼 수 있는 주소에서 참석자를 초대합니다. 앱의 채팅에서는 요청하지 않았다면 먼저 묻습니다. |
| updateCalendarEvent | 주최하는 일정을 바꾸고 초대한 모든 사람에게 업데이트를 보냅니다. 앱의 채팅에서는 요청하지 않았다면 먼저 묻습니다. |
| cancelCalendarEvent | 주최하는 회의를 취소하고 초대한 모든 사람에게 알립니다. 앱의 채팅에서는 항상 먼저 묻습니다. |
| deleteCalendarEvent | 아무에게도 알리지 않고 일정을 캘린더에서 뺍니다. 앱의 채팅에서는 항상 먼저 묻습니다. |
| respondToCalendarEvent | 초대를 수락, 거절 또는 잠정 수락하고 주최자에게 알립니다. 앱의 채팅에서는 요청하지 않았다면 먼저 묻습니다. |
읽기에는 calendar:read가, 모든 변경에는 calendar:write가 필요합니다. 누군가에게 이메일을 보내는 작업에는 emails:send도 필요합니다: 참석자가 있는 회의의 초대, 업데이트, 취소와 초대에 대한 모든 응답.
일부 주소로 제한된 클라이언트는 그중 한 주소가 주최하거나 참석하는 일정만 보고 바꿀 수 있으며, 그 주소에서만 보냅니다.
레퍼런스
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.
입력
fromstring필수- 형식
date-time tostring필수- 형식
date-time timezonestring- 1~64자
limitinteger- 1 이상200 이하
offsetinteger- 0 이상
다른 사용처
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.
입력
idstring- 1~64자
threadIdstring- 1~256자
다른 사용처
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.
입력
summarystring필수- 1~255자
startstring필수- 형식
date-time endstring필수- 형식
date-time descriptionstring- 최대 8000자
locationstring- 최대 255자
urlstring- 최대 2000자형식
uri allDaybooleantimezonestring- 1~64자
recurrencestring- 최대 512자
attendeesobject[]- 최대 200개 항목
emailstring필수- 최대 320자형식
email namestring- 최대 128자
optionalboolean
remindersobject[]- 최대 5개 항목
minutesBeforeinteger필수- 0 이상40320 이하
sendInvitesbooleanfromstring- 최대 320자
다른 사용처
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.
입력
idstring필수- 1~64자
summarystring- 1~255자
startstring- 형식
date-time endstring- 형식
date-time descriptionstring- 최대 8000자
locationstring- 최대 255자
urlstring- 최대 2000자형식
uri allDaybooleantimezonestring- 1~64자
recurrencestring- 최대 512자
attendeesobject[]- 최대 200개 항목
emailstring필수- 최대 320자형식
email namestring- 최대 128자
optionalboolean
remindersobject[]- 최대 5개 항목
minutesBeforeinteger필수- 0 이상40320 이하
sendInvitesbooleanfromstring- 최대 320자
다른 사용처
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.
입력
idstring필수- 1~64자
fromstring- 최대 320자
다른 사용처
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.
입력
idstring필수- 1~64자
다른 사용처
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.
입력
idstring필수- 1~64자
responsestring필수- 다음 중 하나
"ACCEPTED""DECLINED""TENTATIVE" respondingAsstring- 최대 320자