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