提醒和通知
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
日历 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
。
通知
日历支持以下通知类型:
- 创建活动:将新活动添加到用户的其中一个日历中。
- 活动更改:组织者修改了用户受邀参加的活动。
- 活动取消:用户受邀参加的活动被取消。
- 参加者回复:用户所创建活动的参加者更改了自己的回复状态。
- 日程:一天开始时发送的用户日历中所有活动的列表。
用户可以决定每个日历启用哪些通知和递送
方法。这些设置不会与其他
用户。与默认提醒类似,您可以通过
日历列表集合。
向参加者发送已插入活动的电子邮件通知,或
通过 API 更新,请在插入/更新中设置 sendNotifications
参数
设为 true。
传送机制
Google 日历提供的发送方式包括:
- 弹出式窗口。移动平台和 Web 客户端均支持这两种方法。
- 服务器发送的电子邮件。
下表显示了每种提醒或通知类型支持的方法:
|
|
弹出式窗口 |
电子邮件 |
提醒 |
默认提醒 |
✓ |
✓ |
覆盖提醒 |
✓ |
✓ |
通知 |
创建事件 |
❌ |
✓ |
活动变更 |
❌ |
✓ |
活动取消 |
❌ |
✓ |
参加者回复 |
❌ |
✓ |
内容安排 |
❌ |
✓ |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-09。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-09-09\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-09-09。"]]