建立事件
如果您擁有發起人 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 日曆參與者中顯示活動任何日曆 這時您可以看到 設定與會者的出席回覆,或是 直接在參與者的日曆中匯入活動副本。 使用這兩種方法時,您都需要 授予參與者的寫入權限 日曆;如果不是,請考慮 將發起人新增至參與者的聯絡人,系統可能會視情況將主辦人加到 需要參與者聯絡人的寫入權限。
設定參與者的出席回覆
如要設定與會者是否回覆活動邀請,請按照下列步驟操作:
- 在 Google 日曆發起人的日曆中建立活動並新增活動 參與者 (請參閱上方)。
- 使用
Events: update
方法 設定 參與者回覆 至accepted
或tentative
。你必須擁有參與者的寫入權限 日曆。活動可能需要經過一段時間才會顯示在活動上 參與者的日曆。 進一步瞭解如何使用Events: update
方法。
這個方法會將活動新增至參與者的日曆,但與會者可能會 仍然會在電子郵件中看到透過地址傳送邀請的橫幅 對他們來說是未知的
直接在參與者的日曆中匯入活動副本
如要將活動副本匯入參與者的日曆,請按照下列步驟操作 步驟:
- 如果您擁有發起人 Google 日曆的寫入權限,請匯入副本
透過
Events: import
方法,增加圍繞地圖邊緣的邊框間距。 - 在參與者的
使用
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
資源。