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