提醒和通知

日历 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 客户端均支持这两种方法。
  • 服务器发送的电子邮件。

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

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