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 日曆提供的傳送方式如下:
- 彈出式視窗:行動平台和網路用戶端支援上述篩選器。
- 伺服器傳送的電子郵件。
下表列出各種提醒或通知類型支援的方法:
彈出式視窗 | 電子郵件 | ||
---|---|---|---|
提醒 | 預設提醒 | ✓ | ✓ |
覆寫提醒 | ✓ | ✓ | |
通知 | 建立活動 | ❌ | ✓ |
活動變更 | ❌ | ✓ | |
取消活動 | ❌ | ✓ | |
與會者回應 | ❌ | ✓ | |
簡報大綱 | ❌ | ✓ |