邀請使用者參加活動

建立事件

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

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

新增與會者

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

參與者會透過發起人的電子郵件地址收到邀請。Google 敬上 Google 日曆使用者會在電子郵件和/或在日曆中收到邀請。 取決於 Google 日曆設定中的活動設定：

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

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

請勿使用 attendees[].responseStatus敬上 設為 needsAction 以外的任何項目。預先填入參與者的 系統不會自動將活動新增到使用者的日曆。

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

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

設定參與者的出席回覆

如要設定與會者是否回覆活動邀請，請按照下列步驟操作：

  1. 在 Google 日曆發起人的日曆中建立活動並新增活動 參與者 (請參閱上方)。
  2. 使用 Events: update 方法 設定 參與者回覆 至 accepted 或 tentative。你必須擁有參與者的寫入權限 日曆。活動可能需要經過一段時間才會顯示在活動上 參與者的日曆。 進一步瞭解如何使用 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 格式。在上述範例中 取代 20230325T224500Z 和 20230326T001500Z。
  • 開始和結束時區：採用 IANA 時區資料庫名稱的格式。 將時區放在 stz 和 etz 欄位中。
  • 活動說明：必須編碼網址。
  • 事件位置：必須編碼網址。
  • 活動標題：必須編碼網址。

範例

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

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

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

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

事件傳播

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

顯示活動/參與者動態的圖表

共用事件屬性

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

私人活動屬性

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

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

系統只會將活動變更從與會者傳回主辦單位： 參與者的回應狀態，會儲存在 attendees[].responseStatus敬上 資源。