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