리마인더 및 알림

Calendar API는 알림 및 알림을 지원합니다.

  • 리마인더는 일정이 시작되기 전에 지정된 시간에 실행되는 알람입니다.
  • 알림을 사용하면 사용자가 캘린더의 일정 변경사항을 확인할 수 있습니다.

푸시 알림은 사용자에게 전송되지 않고 다른 서버에 캘린더 변경사항을 알리는 푸시 알림과 혼동해서는 안 됩니다.

Google Calendar의 알림에 관한 자세한 내용은 Google Calendar 알림 수정을 참고하세요.

알림

리마인더는 다음으로 구성됩니다.

  • 알림을 표시할 시간입니다. 일정 시작 시간(분) 전으로 표시됩니다.
  • 사용할 게재 방법 (전송 메커니즘 참조)

알림은 전체 캘린더 및 개별 일정에 대해 지정할 수 있습니다. 사용자는 각 캘린더에 기본 알림을 설정할 수 있으며, 이 기본값은 해당 캘린더의 모든 일정에 적용됩니다. 그러나 사용자는 개별 이벤트의 이러한 기본값을 재정의하여 다른 알림 모음으로 대체할 수도 있습니다.

기본 알림

리마인더는 인증된 사용자와 관련된 비공개 정보이며 여러 사용자가 공유되지 않습니다. 결과:

  • 기본 알림은 사용자별 캘린더 메타데이터가 포함된 CalendarList 컬렉션을 통해 조작됩니다.
  • 모든 사용자가 공유하는 전역 메타데이터가 포함된 Calendar 컬렉션을 통해서는 액세스할 수 없습니다.

이벤트 목록 쿼리를 실행할 때도 기본 알림이 반환됩니다.

기본 알림 재정의

이벤트를 삽입하거나 수정할 때 기본 알림을 재정의하려면 reminders.useDefaultfalse로 설정하고 새 알림 집합으로 reminders.overrides를 채웁니다.

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

기본 알림 세트로 되돌리려면 업데이트 설정 reminders.useDefault를 다시 true로 실행합니다.

알림

캘린더에서 지원하는 알림 유형은 다음과 같습니다.

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

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

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

전송 메커니즘

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

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

다음 표는 각 알림 또는 알림 유형에 지원되는 방법을 보여줍니다.

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