리마인더

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Calendar API는 리마인더 및 알림을 지원합니다.

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

두 번째 항목을 사용자에게 전송하는 대신 다른 서버에 캘린더의 변경사항을 알리는 푸시 알림과 혼동해서는 안 됩니다.

Google Calendar의 알림에 대한 자세한 내용은 Google Calendar 알림 수정하기를 참고하세요.

알림

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

  • 미리 알림 표시 시점(일정 시작 시간 전의 분으로 표시)
  • 사용할 게재 방법 (게재 메커니즘 참조)

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

기본 알림

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

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

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

기본 알림 재정의

이벤트를 삽입하거나 수정할 때 기본 알림을 재정의하려면 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로 설정하세요.

알림

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

  • 일정 생성: 새 일정이 사용자의 캘린더 중 하나에 추가됩니다.
  • 일정 변경: 주최자가 사용자가 초대된 일정을 수정했습니다.
  • 일정 취소: 사용자가 초대된 일정이 취소됩니다.
  • 참석자 응답: 사용자가 만든 일정의 참석자의 응답 상태가 변경되었습니다.
  • 주제: 사용자 캘린더에 있는 모든 일정의 목록이며 오늘 자정에 전송됩니다.

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

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

전송 메커니즘

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

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

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

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