返回導約首頁

導約整合文件

在導約連結、使用與移除 Google Calendar

這份文件說明工作室服務人員如何從導約後台連結自己的 Google Calendar、如何讓預約避開既有行程、如何把已確認預約寫回日曆，以及 Google Meet 連結如何透過 Calendar event 產生。

連結位置

老師設定頁的 Google Calendar 整合區塊。

主要用途

讀取可選日曆、同步忙碌時段，並寫入正式成立預約。

資料邊界

OAuth token 加密保存，Google 資料只用於預約營運。

新增 Google Calendar 連結

  1. 1登入導約後台，打開「老師設定」。
  2. 2選擇要管理的服務人員。
  3. 3在 Google Calendar 整合區塊點選「連結 Google Calendar」。
  4. 4在 Google 授權頁確認導約要求的 Calendar 權限。
  5. 5完成授權並回到導約後，確認系統已載入可用日曆清單。
  6. 6選擇要用來阻擋公開預約的 read-busy 日曆，並指定一個可寫入的 write-target 日曆。

連結入口位於登入後的導約後台「老師設定」頁；公開文件不列出工作室專屬後台連結。

Google Calendar 如何用在預約

  1. 1服務人員先在後台設定自己的可預約時段。
  2. 2導約會用已選取的 Google Calendar 行程作為忙碌區塊，從可預約時段中扣除衝突時間。
  3. 3客戶送出預約申請後，工作室管理者在後台接受該 booking；若服務要求成立前付款，系統會等付款實際完成後才寫入日曆。
  4. 4在 booking 正式成立時，導約會在服務人員指定的 write-target 日曆建立預約事件。
  5. 5如果預約改期或取消，導約會同步更新或刪除對應的 Calendar event。

Google Meet 連結如何產生

導約沒有要求另外的 Google Meet API 權限。當線上服務設定使用 Google Meet，且服務人員的 Google Calendar 已完成連結與寫入日曆設定時，導約會在建立 Google Calendar 預約事件時一併加入 conference data，讓 Google 產生 Google Meet 參加連結。

Google Meet 連結只會在 booking 正式成立時產生並保存。需要 PayUni 或手動匯款的成立前付款服務，會在付款實際完成前保留安全的公開線上說明，不會建立 Calendar event，也不會提供 Google Meet join URL。

Google Meet 連結只會用於該筆已確認預約，不會用來讀取會議內容、錄影、聊天紀錄或參與者清單。

Google Meet 是 Calendar event 的會議連結，不是獨立會議資料讀取功能。

Reviewer test flow

  1. 1Sign in at https://daoyue.app/admin/login with the reviewer account provided through the secure handoff channel.
  2. 2Open https://daoyue.app/admin/google-review/availability.
  3. 3Click 連結 Google Calendar and authorize this app with your test Google account.
  4. 4Select at least one read-busy calendar and one write-target calendar.
  5. 5Open https://daoyue.app/w/google-review.
  6. 6Submit a booking for Google Review Online Session.
  7. 7Return to https://daoyue.app/admin/google-review/bookings and accept the pending booking.
  8. 8Confirm the write-target calendar contains the booking event and the booking shows the Google Meet join link.

The review service is intentionally no-payment so admin acceptance is the formal confirmation boundary that creates the Calendar event and Google Meet link.

Support

Email support:[email protected]

Support hours: Monday to Friday, 09:00-18:00 Taipei time, excluding Taiwan public holidays.

First response SLA: one business day for standard support requests. OAuth review blockers, Calendar authorization issues, and Google Meet creation failures are triaged as priority support requests.

Please include your workspace slug, affected booking time, connected Google account label, and whether the issue happened while authorizing, selecting calendars, creating a booking event, or generating a Meet link. Do not send OAuth tokens, client secrets, private client notes, or real Calendar event details by email.

解除 Google Calendar 連結

  1. 1在導約後台打開「老師設定」。
  2. 2選擇已連結 Google Calendar 的服務人員。
  3. 3在 Google Calendar 整合區塊點選「解除連結」。
  4. 4確認解除後，導約會停止推播通道、撤銷 refresh token，並刪除本地保存的日曆連結資料與相關忙碌區塊。
  5. 5如有需要，也可以到 Google 帳號的第三方授權管理頁移除導約存取權。

資料與權限說明

導約目前要求的 Google Calendar scopes 為 calendar.calendarlist.readonly 與 calendar.events。calendar.calendarlist.readonly 用於列出服務人員可選的日曆；calendar.events 用於讀取選定日曆的忙碌時段，並在指定日曆建立、更新或刪除導約預約事件。

導約不會把 Google Calendar 或 Google Meet 資料用於廣告投放、轉售、信用評分、模型訓練，或任何與預約營運無關的用途。從外部日曆讀到的既有行程不會在個案端揭露原始標題或內容，只會形成不可預約的忙碌區塊。

詳細資料處理方式請見隱私權政策與服務條款。