提醒和通知

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 客户端都支持这些功能。
  • 服务器发送的电子邮件

下表显示了每种提醒或通知类型支持的方法:

弹出式窗口 电子邮件
提醒 默认提醒
替换提醒
通知 事件创建
活动更改
活动取消
参加者回复
内容安排