日历 API 提供对提醒和通知的支持。
- 提醒是指在活动开始前的特定时间触发的闹钟。
- 借助通知，用户可以了解其日历中活动的变更。
第二项内容不应与推送通知混淆，推送通知不会传送给用户，而是通知其他服务器日历更改。
如需详细了解 Google 日历中的通知，请参阅修改 Google 日历通知。
提醒
提醒包括：
- 显示提醒的时间，表示为活动开始时间之前的分钟数
- 要使用的投放方式（请参阅投放机制）
您可以为整个日历和个别活动指定提醒。用户可以为每个日历设置默认提醒；这些默认设置适用于相应日历中的所有活动。不过，用户也可以针对个别事件替换这些默认设置，将其替换为一组不同的提醒。
默认提醒
提醒是专用于经过身份验证的用户的私人信息；它们不会在多位用户之间共享。因此：
- 默认提醒可通过日历列表集合来操作，该集合包含特定于用户的日历元数据
- 而不能通过日历集合访问它们，该集合包含在所有用户之间共享的全局元数据。
执行活动列表查询时，系统也会返回默认提醒。
覆盖默认提醒
如需在插入或修改活动时替换默认提醒，请将 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。
通知
日历支持以下通知类型：
- 创建活动：将新活动添加到用户的其中一个日历中。
- 活动更改：组织者修改了用户受邀参加的活动。
- 活动取消：用户受邀参加的活动被取消。
- 参加者回复：用户所创建活动的参加者更改了自己的回复状态。
- 日程：一天开始时发送的用户日历中所有活动的列表。
用户可以决定每个日历启用哪些通知以及每种通知类型的传送方法。这些设置不会与其他用户共享。与默认提醒类似，您也可以通过 calendarList 集合访问这些提醒。
对于通过 API 插入或更新的事件，如需向参加者发送电子邮件通知，请将插入/更新请求中的 sendNotifications 参数设为 true。
传送机制
Google 日历提供的发送方式包括：
- 弹出式窗口。移动平台和 Web 客户端均支持这两种方法。
- 服务器发送的电子邮件。
下表显示了每种提醒或通知类型支持的方法：
| Pop-up | |||
|---|---|---|---|
| 提醒 | 默认提醒 | ✓ | ✓ |
| 覆盖提醒 | ✓ | ✓ | |
| 通知 | 创建事件 | ❌ | ✓ |
| 活动变更 | ❌ | ✓ | |
| 活动取消 | ❌ | ✓ | |
| 参加者回复 | ❌ | ✓ | |
| 内容安排 | ❌ | ✓ |