邀請使用者參加活動

建立事件

如果您擁有發起人 Google 日曆的寫入權限,就可以新增 使用 Events: insert 設定事件 方法。

這個方法會將活動直接新增至發起人的日曆 (單獨新增) 允許他們新增邀請

新增與會者

透過這種方式,您還可以將參與者新增到同一個活動,方法是將參與者 將電子郵件地址設為 attendees 事件的 屬性。發起人日後對活動所做的變更,都會是 傳播給參與者。

出席者會收到發起人的電子郵件地址寄出的邀請。Google 日曆使用者會在電子郵件和/或日曆中收到邀請,具體取決於 Google 日曆設定中的「活動」設定:

  • 如果對方設定為 From everyone,系統會直接將活動新增到對方的日曆
  • 如果對方設為 Only if the sender is known 設定,系統就會新增事件 以便直接從自己的日曆存取 發起人、發起人隸屬於同一個機構,或是發起人是發起人 位於 Google 聯絡人中。如果發起人 在邀請電子郵件中按一下「是」或「不確定」。則事件是 加入自己的日曆。
  • 如果使用者啟用了 When I respond in email 設定,系統就不會傳送所有邀請 會新增至日曆,直到使用者回覆邀請時,方法是按一下 [是]、[不確定]、 或者邀請電子郵件中的「否」

如要進一步瞭解將邀請新增至 Google 日曆的方式,請參閱: 在 Google 日曆中管理邀請

直接在與會者的日曆中顯示活動

如要直接在 Google 日曆參與者的日曆中顯示活動,並針對參與者可能有的任何設定,您可以設定參與者的敬請回覆,或直接在參與者的日曆中匯入活動副本。使用這兩種方法時,您都需要 授予參與者的寫入權限 日曆;如果不是,請考慮 將發起人新增至參與者的聯絡人,系統可能會視情況將主辦人加到 需要參與者聯絡人的寫入權限。

設定參與者的出席回覆

如要設定與會者對活動的回覆,請按照下列步驟操作:

  1. 在 Google 日曆發起人的日曆中建立活動並新增活動 參與者 (請參閱上方)。
  2. 使用 Events: update 方法 設定 參與者回覆acceptedtentative。你必須擁有參與者的寫入權限 日曆。活動可能會稍微延遲才會顯示在出席者的日曆中。進一步瞭解如何使用 Events: update 方法

這個方法會將活動新增至參與者的日曆,但與會者可能會 仍然會在電子郵件中看到透過地址傳送邀請的橫幅 對他們來說是未知的

直接在參與者的日曆中匯入活動副本

如要將活動副本匯入參與者的日曆,請按照下列步驟操作 步驟:

  1. 如果您擁有發起人 Google 日曆的寫入權限,請匯入副本 透過 Events: import 方法,增加圍繞地圖邊緣的邊框間距。
  2. 在參與者的 使用 Events: import 管理日曆。 你必須擁有參與者日曆的寫入權限。使用相同的事件 ID (iCalUID) 適用於 發起人與參與者的副本,並務必指定發起人 就可以看到

透過這個方法,與會者無法在自己的日曆中查看活動,但無法查看 收到來自 Google 日曆的邀請電子郵件。

將發起人新增為參與者的聯絡人

如果您沒有參與者的憑證,可以指示與會者或 將主辦人的電子郵件地址新增至其 Google 聯絡人 直接在他們的日曆中顯示活動。其中可能有 新建立的聯絡人稍後才會生效。

  • 請 Google 日曆使用者將發起人新增至他們的 Google 聯絡人
  • 如果參與者隸屬於某個機構,您可以詢問該機構的 透過程式為使用者新增電子郵件地址 聯絡人。請管理員啟用全網域委派功能,模擬使用者並使用 People: createContact 方法為每位使用者建立聯絡人,確保日後來自這些電子郵件地址的邀請會自動顯示在使用者的日曆中。
  • 如果您可以存取參與者的聯絡人,還可以將 方法是使用 People: createContact 方法,增加圍繞地圖邊緣的邊框間距。

透過電子郵件地址邀請使用者

如果你沒有發起人 Google 日曆的寫入權限,或 如果不想顯示主辦者的電子郵件地址,請使用 i 行事曆 通訊協定 (RFC-5545)。 透過 .ICS 檔案邀請使用者透過電子郵件聯絡。

如果與會者是具備 Only if the sender is known 設定的 Google 日曆使用者,而且未曾將地址互動或記錄為 就不會在對方按一下 「新增至日曆」或回覆活動邀請。

或者,如果希望 Google 日曆使用者能夠 一次處理一項活動,而無需持續更新,您也能提供 為使用者新增的事件這個方法會在使用者日曆中建立獨立的活動,但您必須有權存取使用者日曆,才能更新該活動。

使用下列連結範本:


https://calendar.google.com/calendar/r/eventedit?action=TEMPLATE&dates=20230325T224500Z%2F20230326T001500Z&stz=Europe/Brussels&etz=Europe/Brussels&details=EVENT_DESCRIPTION_HERE&location=EVENT_LOCATION_HERE&text=EVENT_TITLE_HERE

來更新下列資訊:

  • 開始與結束日期和時間:請使用 ISO 8601 格式。在上述範例中 取代 20230325T224500Z20230326T001500Z
  • 開始和結束時區:採用 IANA 時區資料庫名稱的格式。 將時區放在 stzetz 欄位中。
  • 事件說明:必須使用網址編碼。
  • 事件位置:必須使用網址編碼。
  • 活動標題:必須編碼網址。

範例

我們以建立預約服務為例 使用者向商家預約。使用者進行預約時,您 你想透過你的服務,在預約者的 以及商家的 Google 服務中新增活動 日曆。

為提供最佳使用者體驗,建議企業授予寫入權限 加入對方的日曆,你就能直接將活動新增至商家的 日曆 (建立活動),並邀請預約者參加該活動 (「新增參與者」)。為了確保預約人員能在 就會收到提醒,請通知他們檢查電子郵件, 預訂完成後,請立即回覆「是」參加活動。使用者回覆 系統就會傳送 Google 日曆的活動通知 根據訂閱者的通知設定

如要將活動直接新增至預約者的日曆,請通知預約者。 可新增為聯絡人 用於接收邀請的電子郵件地址。另外 要求預約者開放日曆的寫入權限,以程式輔助方式回覆他們 (設定與會者的出席回覆),並傳送電子郵件給對方 已確認的預訂通知。

如果商家不想公開電子郵件地址,請使用使用者專屬 電子郵件地址,透過電子郵件將活動傳送給預約者 (透過電子郵件地址邀請使用者)。

事件傳播

下圖說明動態值。首先,Jack 在 GCP 上建立事件 自己的主日曆 (並因此擁有主辦者副本)。接著,他邀請 儲存格課程次要日曆和 Susan (擁有活動設定) Only if the sender is known。參與者大提琴課上會複製 群組次要日曆,如果她知道小傑,就會在 Susan 的日曆上 。當 Susan 回覆時,系統會將 RSVP 變更內容傳回給活動主辦人,並使用 Susan 的回覆內容更新活動主辦人的副本。您對活動發起人的活動副本所做的變更 都會套用到其他參與者

顯示活動/出席者動態的圖表

共用事件屬性

建立活動的日曆是主辦人日曆。這個日曆會擁有共用的活動資訊,包括 ID、開始和結束時間、摘要和說明。發起人更新這項資訊時 日曆,變更就會套用至參與者副本。

私人活動屬性

並非所有活動副本都會分享所有資訊。 資訊,例如提醒、colorId、資訊公開,或是 extendedProperties.private 屬性。這些屬性是由 參與者的設定,而非發起人日曆。

此外,參與者也可以變更活動的共用屬性。不過, 變更內容只會反映在自己的副本上,如果發起人可能會遺失變更 並進行變更。

從與會者傳回給發起人的唯一活動變更,是儲存在 attendees[].responseStatus 屬性中的與會者回覆狀態。