提醒與通知

Calendar API 支援提醒和通知。

  • 提醒:鬧鐘會在活動開始前的指定時間觸發。
  • 通知:方便使用者瞭解日曆中的活動異動。

後者不應與 push 收到的通知 或是通知其他伺服器日曆的變更。

如要進一步瞭解 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 日曆支援下列通知類型:

  • 建立活動:系統會在使用者的其中一個日曆新增活動。
  • 活動變更:主辦者修改了使用者受邀參加的活動。
  • 取消活動:使用者受邀參加的活動已取消。
  • 與會者回應:使用者所建立活動的參與者變更了自己的回覆狀態。
  • 待辦事項:在當天開始時傳送的使用者日曆中所有活動清單。

使用者可以決定每個日曆和傳送工作要啟用哪些通知 方法。這些設定不會與其他應用程式共用 使用者。這類提醒與預設提醒類似 日曆清單集合。

針對插入或插入的活動,傳送電子郵件通知給參與者 已透過 API 更新,請在 insert/update 中設定 sendNotifications 參數 要求為 true

傳送機制

Google 日曆提供的傳送方式如下:

  • 彈出式視窗:行動平台和網路用戶端支援上述篩選器。
  • 伺服器傳送的電子郵件

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

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