提醒與通知

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 插入或更新的活動，向與會者傳送電子郵件通知，請呼叫 insert 或 update 方法，並將 sendUpdates 參數設為 "all" 或 "externalOnly"。

交付機制

Google 日曆提供下列傳送方式：

  • 彈出式視窗。行動平台和網路用戶端都支援這些功能。
  • 伺服器傳送的電子郵件。

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

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