提醒與通知

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 日曆提供的提交方式如下:

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

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

彈出式視窗 電子郵件
提醒 預設提醒
覆寫提醒
通知 建立事件
事件變更
取消活動
與會者回覆
大綱