提醒與通知

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。

通知

日曆支援下列通知類型：

• 建立活動：將新活動新增至使用者的其中一個日曆。
• 事件變更：主辦人修改了使用者受邀參加的活動。
• 活動取消：使用者受邀參加的活動遭到取消。
• 出席者回應：使用者建立的活動出席者變更回覆狀態。
• 議程：使用者日曆中所有活動的清單，會在一天開始時傳送。

使用者可以決定要為每個日曆啟用哪些通知，以及每個通知類型的傳送方式。這些設定不會與其他使用者共用。與預設提醒一樣，您可以透過 CalendarList 集合存取這些提醒。

如要針對透過 API 插入或更新的事件，傳送電子郵件通知給與會者，請將插入/更新要求中的 sendNotifications 參數設為 true。

提交機制

Google 日曆提供的提交方式如下：

• 彈出式視窗。行動平台和網路用戶端都支援這些功能。
• 伺服器傳送的電子郵件。

下表列出各提醒或通知類型支援的方法：