Calendar API 支持提醒和通知。
- 提醒是指在活动开始前指定的时间触发的闹钟。
- 借助通知，用户可以了解日历中活动的更改情况。
后一项不应与推送 通知混淆，推送通知不会发送给用户，而是会向其他服务器通知日历的更改情况。
如需详细了解 Google 日历中的通知，请参阅 修改 Google 日历通知。
提醒
提醒包含以下内容：
- 显示提醒的时间，以活动开始时间前多少分钟表示
- 要使用的传送方式（请参阅传送机制）
您可以为整个日历和单个活动指定提醒。用户可以为每个日历设置默认提醒；这些默认提醒适用于该日历中的所有活动。 不过，用户也可以替换这些默认提醒，为单个活动设置不同的提醒。
默认提醒
提醒是特定于经过身份验证的用户的私密信息；它们 不会在多个用户之间共享。因此：
- 默认提醒通过 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。
通知
日历支持以下通知类型：
- 活动创建：用户的某个日历中添加了新活动。
- 活动更改：组织者修改了用户受邀参加的活动。
- 活动取消：用户受邀参加的活动被取消。
- 参加者回复：用户创建的活动的参加者更改了其回复状态。
- 日程：用户日历中所有活动的列表，在每天开始时发送。
用户可以决定为每个日历启用哪些通知，以及每种通知类型的传送方式。这些设置不会与其他用户共享。与默认提醒类似，它们可以通过 CalendarList 集合访问。
如需为使用 API 插入或
更新的活动向参加者发送电子邮件通知，请调用
insert或
update方法，并将
sendUpdates参数设置为"all"或"externalOnly"。
传送机制
Google 日历提供的传送方式包括：
- 弹出式窗口。 移动平台和 Web 客户端均支持此方式。
- 服务器发送的电子邮件。
下表展示了每种提醒或通知类型支持的方法：
| 弹出式窗口 | 电子邮件 | ||
|---|---|---|---|
| 提醒 | 默认提醒 | ✓ | ✓ |
| 替换提醒 | ✓ | ✓ | |
| 通知 | 活动创建 | ❌ | ✓ |
| 活动更改 | ❌ | ✓ | |
| 活动取消 | ❌ | ✓ | |
| 参加者回复 | ❌ | ✓ | |
| 日程 | ❌ | ✓ |