提醒與通知

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 插入或更新的事件傳送電子郵件通知給參與者，請在 insert/update 要求中將 sendNotifications 參數設為 true。

傳送機制

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

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

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

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