리마인더 및 알림

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로 실행합니다.

알림

캘린더는 다음과 같은 알림 유형을 지원합니다.

• 일정 생성: 사용자의 캘린더 중 하나에 새 일정이 추가됩니다.
• 일정 변경: 주최자가 사용자가 초대된 일정을 수정했습니다.
• 일정 취소: 사용자가 초대된 일정이 취소되었습니다.
• 참석자 응답: 사용자가 만든 일정의 참석자가 응답 상태를 변경했습니다.
• Agenda: 사용자 캘린더의 모든 일정 목록으로, 하루가 시작될 때 전송됩니다.

사용자는 캘린더별로 사용 설정할 알림과 각 알림 유형의 전송 방법을 결정할 수 있습니다. 이 설정은 다른 사용자와 공유되지 않습니다. 기본 알림과 마찬가지로 CalendarList 컬렉션을 통해 알림에 액세스할 수 있습니다.

API를 통해 삽입되거나 업데이트된 이벤트에 대해 참석자에게 이메일 알림을 보내려면 삽입/업데이트 요청의 sendNotifications 매개변수를 true로 설정합니다.

전송 메커니즘

Google Calendar에서 제공하는 전송 방법은 다음과 같습니다.

• 팝업. 이 API는 모바일 플랫폼과 웹 클라이언트에서 지원됩니다.
• 서버에서 전송한 이메일입니다.

다음 표에는 각 알림 또는 알림 유형에 지원되는 메서드가 나와 있습니다.

		팝업	이메일
리마인더	기본 알림	✓	✓
	알림 재정의	✓	✓
알림	이벤트 생성	❌	✓
	일정 변경	❌	✓
	이벤트 취소	❌	✓
	참석자 응답	❌	✓
	주제	❌	✓