Calendar API는 리마인더 및 알림을 지원합니다.
- 리마인더는 일정이 시작되기 전에 지정된 시간에 트리거되는 알람입니다.
- 알림을 사용하면 사용자가 캘린더의 일정 변경사항을 확인할 수 있습니다.
후자는 사용자에게 전송되는 대신 다른 서버에 캘린더 변경사항을 알리는 푸시 알림과 혼동해서는 안 됩니다.
Google Calendar의 알림에 관한 자세한 내용은 Google Calendar 알림 수정을 참고하세요.
알림
리마인더는 다음으로 구성됩니다.
- 알림을 표시할 시점입니다. 일정 시작 시간(분) 전으로 표시됩니다.
- 사용할 게재 방법 (전송 메커니즘 참조)
전체 캘린더와 개별 일정에 리마인더를 지정할 수 있습니다. 사용자는 각 캘린더에 기본 리마인더를 설정할 수 있습니다. 이 기본값은 해당 캘린더 내의 모든 일정에 적용됩니다. 하지만 사용자는 개별 일정에 대해 이러한 기본값을 재정의하여 다른 리마인더 세트로 대체할 수도 있습니다.
기본 리마인더
리마인더는 인증된 사용자와 관련된 비공개 정보이며 여러 사용자에게 공유되지 않습니다. 결과:
- 기본 리마인더는 사용자별 캘린더 메타데이터가 포함된 CalendarList 컬렉션을 통해 조작됩니다.
- 모든 사용자와 공유되는 글로벌 메타데이터가 포함된 캘린더 모음을 통해 액세스할 수는 없습니다.
이벤트 목록 쿼리를 실행할 때도 기본 리마인더가 반환됩니다.
기본 알림 재정의
이벤트를 삽입하거나 수정할 때 기본 알림을 재정의하려면 reminders.useDefault를 false
로 설정하고 새 알림 집합으로 reminders.overrides를 채웁니다.
"reminders": {
"useDefault": false,
# Overrides can be set if and only if useDefault is false.
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
},
# ...
]
}
기본 리마인더 세트로 되돌리려면 reminders.useDefault 설정을 true
로 다시 업데이트합니다.
알림
Calendar는 다음과 같은 알림 유형을 지원합니다.
- 이벤트 생성: 사용자의 캘린더 중 하나에 새 일정이 추가됩니다.
- 일정 변경: 주최자가 사용자가 초대된 일정을 수정했습니다.
- 이벤트 취소: 사용자가 초대된 이벤트가 취소됩니다.
- 참석자 응답: 사용자가 만든 일정의 참석자가 응답 상태를 변경했습니다.
- 일정: 하루가 시작될 때 전송되는 사용자 캘린더의 모든 일정 목록입니다.
사용자는 캘린더별로 사용 설정할 알림과 각 알림 유형의 전송 방법을 결정할 수 있습니다. 이 설정은 다른 사용자와 공유되지 않습니다. 기본 리마인더와 마찬가지로 CalendarList 컬렉션을 통해 액세스할 수 있습니다.
API를 통해 삽입되거나 업데이트된 이벤트에 대해 참석자에게 이메일 알림을 보내려면 삽입/업데이트 요청의 sendNotifications
매개변수를 true로 설정합니다.
전송 메커니즘
Google Calendar에서 제공하는 전송 방식은 다음과 같습니다.
- 팝업 이 기능은 모바일 플랫폼과 웹 클라이언트에서 지원됩니다.
- 서버에서 전송한 이메일입니다.
다음 표는 각 알림 또는 알림 유형에 지원되는 방법을 보여줍니다.
팝업 | 이메일 | ||
---|---|---|---|
알림 | 기본 리마인더 | ✓ | ✓ |
리마인더 재정의 | ✓ | ✓ | |
알림 | 이벤트 생성 | ❌ | ✓ |
이벤트 변경 | ❌ | ✓ | |
일정 취소 | ❌ | ✓ | |
참석자 응답 | ❌ | ✓ | |
주제 | ❌ | ✓ |