提醒和通知

Google 日历 API 支持提醒和通知。

• 提醒 是在活动开始前指定的时间触发的闹钟。
• 借助通知 ，用户可以了解日历中活动的更改情况。

请勿将通知与推送通知混淆，推送通知会向其他服务器通知日历的更改，而不是向用户发送通知。

如需详细了解 Google 日历中的通知，请参阅 修改 Google 日历通知。

提醒

提醒包含以下内容：

• 显示提醒的时间，以活动开始时间前多少分钟表示。
• 要使用的投放方式（请参阅投放机制）。

您可以为整个日历和单个活动指定提醒。用户可以为每个日历设置 默认提醒 ；这些默认提醒适用于该日历中的所有活动。不过，用户也可以替换单个活动的这些默认提醒，改为使用另一组提醒。

默认提醒

提醒是特定于经过身份验证的用户的私密信息；它们 不会 在多个用户之间共享。因此：

• 默认提醒通过 CalendarList 集合进行操作，该集合包含特定于用户的日历元数据。
• 它们 无法 通过 Calendars 集合访问，该集合包含在所有用户之间共享的全局元数据。

执行活动列表查询时，系统也会返回默认提醒。

替换默认提醒

如需在创建或更新活动时替换默认提醒，请将 reminders.useDefault 设置为 false，并使用新的提醒集填充 reminders.overrides 。只有在 useDefault 为 false 时，才能设置替换，如以下示例所示：

"reminders": {
  "useDefault": false,
  "overrides": [
    {
      "method": "reminderMethod",
      "minutes": "reminderMinutes"
    }
  ]
}

如需恢复为默认提醒集，请执行更新，将 reminders.useDefault 重新设置为 true。

通知

日历支持以下通知类型：

• 活动创建：用户的一个日历中添加了新活动。
• 活动更改：组织者修改了用户受邀参加的活动。
• 活动取消：用户受邀参加的活动被取消。
• 参加者回复：参加者更改了对用户创建的活动的回复状态。
• 内容安排：用户日历中所有活动的列表，在每天开始时发送。

用户可以决定为每个日历启用哪些通知，以及每种通知类型的投放方式。这些设置不会与其他用户共享。与默认提醒类似，它们可以通过 CalendarList 集合访问。

如需向使用 API 插入或 更新的活动的参加者发送电子邮件通知，请调用 insert或 update方法，并将 sendUpdates参数设置为"all"或"externalOnly"。

**注意**： 对于使用非 Google 电子邮件地址的参加者，这些通知电子邮件 是他们了解活动的唯一方式；系统不会自动将活动添加到 他们的日历中。

投放机制

Google 日历提供的投放方式包括：

• 弹出式窗口 。移动平台和 Web 客户端均支持这些窗口。
• 由服务器发送的电子邮件 。

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

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