리마인더 및 알림

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

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

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

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

리마인더

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

• 일정 시작 시간 전의 시간(분)으로 표시되는 리마인더를 표시할 시점
• 사용할 전송 방법 (전송 메커니즘 참고)

리마인더는 전체 캘린더와 개별 일정에 지정할 수 있습니다. 사용자는 각 캘린더에 기본 리마인더 를 설정할 수 있습니다. 이러한 기본값은 해당 캘린더 내의 모든 일정에 적용됩니다. 그러나 사용자는 개별 일정에 이러한 기본값을 재정의하여 다른 리마인더 집합으로 바꿀 수도 있습니다.

기본 리마인더

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

• 기본 리마인더는 사용자별 캘린더 메타데이터가 포함된 CalendarList 컬렉션을 통해 조작됩니다.
• 모든 사용자 간에 공유되는 전역 메타데이터가 포함된 Calendars 컬렉션을 통해 액세스할 수 없습니다.

기본 리마인더는 일정 목록 쿼리를 실행할 때도 반환됩니다.

기본 리마인더 재정의

일정을 삽입하거나 수정할 때 기본 리마인더를 재정의하려면 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로 삽입되거나 업데이트된 일정에 대해 참석자에게 이메일 알림을 보내려면 insert 또는 update 메서드를 호출하고 sendUpdates 매개변수를 "all" 또는 "externalOnly"로 설정합니다.

전송 메커니즘

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

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

다음 표에서는 각 리마인더 또는 알림 유형에 지원되는 메서드를 보여줍니다.