提醒與通知

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 日曆支援的傳送方式如下:

  • 彈出式視窗:而且適用於行動平台和網路用戶端。
  • 伺服器傳送的電子郵件

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

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