Zoho 日曆
Zoho Calendar 是一款在線商務日曆，可讓您輕鬆安排日程安排。 您可以使用它來掌握您的日程安排，還可以與您的團隊共享日曆，讓每個人都在同一頁上。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Zoho 日曆 |
| URL | https://www.zoho.com/calendar/contact.html |
| zmintegration@zohomail.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Zoho郵件 |
| 網站 | https://www.zoho.com/calendar/ |
| 隱私策略 | https://www.zoho.com/privacy.html |
| 類別 | 通敵;生產力 |
Zoho 日曆
Zoho Calendar 是一款在線商務日曆，可讓您輕鬆安排日程安排。 Zoho Calendar 連接器使您能夠管理日曆並執行重複操作，例如通過使用操作觸發模型創建工作流程來創建、編輯、刪除事件。
先決條件
已驗證的 Zoho Calendar 帳戶。 點擊 此處 建立您的第一個帳戶。
如何取得認證
當您建立新連線時，
- 選取您的 Zoho 帳戶所在的網域。
- 輸入您的 Zoho Calendar 憑證。
- 即使 Power App 與其他使用者共用，他們也應該建立新的連線才能開始使用它。
Zoho Calendar API 使用 OAuth2.0 進行身份驗證，因此一旦設置帳戶，就不需要輔助身份驗證。
開始使用連接器
請依照以下步驟連接到 Zoho 日曆：
- 登入您的 Power Automate 帳戶，然後按一下左側功能表中的 [建立]。
- 您可以選擇建立雲端流程、桌面流程或商務流程。 若要連線至 Zoho Calendar，請選擇自動化雲端流程。
- 您可以建立流程/範本。
- 輸入相應動作所需的值。
已知問題和限制
- 目前，連接器不支援週期性事件。
常見錯誤和補救措施
- 若要避免驗證錯誤，請選擇託管 Zoho Calendar 帳戶的網域。
FAQ
https://www.zoho.com/calendar/help/getting-started.html
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 選取您的 Zoho 帳戶資料所在的區域。 | 字串 | 選取網域。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 刪除事件 |
從使用者的行事曆中刪除事件。 |
| 取得事件清單 |
以 yyyy-MM-ddTHH：mm：sszzz 格式取得指定日期範圍之間的所有事件清單。 |
| 取得活動 |
從使用者指定的行事曆中取得特定事件的詳細資料，例如事件標題、開始日期、結束日期等。 |
| 取得行事曆清單 |
取得具有行事曆 UID、名稱和時區的所有行事曆清單。 |
| 取得行事曆詳細資料 |
使用行事曆 UID 擷取特定行事曆的詳細資料。 |
| 建立新事件 |
將新事件新增至使用者的行事曆。 |
| 搜尋事件 |
取得所有行事曆中的事件清單。 |
| 更新事件 |
更新使用者行事曆中的現有事件。 |
刪除事件
從使用者的行事曆中刪除事件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
日曆
|
cuid | True | string |
指定行事曆或輸入行事曆的唯一識別碼。 |
|
Event
|
euid | True | string |
輸入事件的唯一 ID。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
events
|
events | array of object |
events |
|
uid
|
events.uid | string |
uid |
|
recurrenceid
|
events.recurrenceid | string |
recurrenceid |
取得事件清單
以 yyyy-MM-ddTHH：mm：sszzz 格式取得指定日期範圍之間的所有事件清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
日曆
|
cuid | True | string |
指定行事曆或輸入行事曆的唯一識別碼。 |
|
依實例
|
byinstance | True | boolean |
當重複事件設定為 true 時，將重複事件的所有實例擷取為個別事件。 日期範圍不應超過 31 天。 |
|
開始時間
|
start | True | string |
以 yyyy-MM-ddThh：mm：sszzz 格式指定開始時間 |
|
結束時間
|
end | True | string |
以 yyyy-MM-ddThh：mm：sszzz 格式指定結束時間 |
|
Timezone
|
timezone | string |
指定活動的時區 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
events
|
events | array of SingleEventRes |
events |
取得活動
從使用者指定的行事曆中取得特定事件的詳細資料，例如事件標題、開始日期、結束日期等。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
日曆
|
cuid | True | string |
指定行事曆或輸入行事曆的唯一識別碼。 |
|
Event
|
euid | True | string |
輸入事件的唯一 ID。 |
傳回
取得行事曆清單
取得具有行事曆 UID、名稱和時區的所有行事曆清單。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
日曆
|
calendars | array of SingleCalendarRes |
日曆 |
取得行事曆詳細資料
使用行事曆 UID 擷取特定行事曆的詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
日曆
|
cuid | True | string |
指定行事曆或輸入行事曆的唯一識別碼。 |
傳回
建立新事件
將新事件新增至使用者的行事曆。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
日曆
|
cuid | True | string |
指定行事曆或輸入行事曆的唯一識別碼。 |
|
Title
|
title | True | string |
指定事件標題 |
|
開始時間
|
start | True | string |
以 yyyy-MM-ddTHH：mm：sszzz 格式指定事件開始時間 |
|
結束時間
|
end | True | string |
以 yyyy-MM-ddTHH：mm：sszzz 格式指定事件結束時間 |
|
Timezone
|
timezone | string |
指定活動的時區 |
|
|
顏色
|
color | string |
選擇事件顏色或指定顏色的十六進位值 |
|
|
Description
|
description | string |
指定事件的描述 |
|
|
地點
|
location | string |
指定活動的位置 |
|
|
URL
|
url | string |
指定事件的 URL |
|
|
私人
|
isprivate | boolean |
指定事件是否為私人 |
|
|
是一整天
|
isallday | boolean |
指定事件是否為全天事件。 |
|
|
電子郵件 ID
|
string |
指定出席者的電子郵件地址 |
||
|
透明度
|
transparency | integer |
指定是否應將活動新增至您的空閒/忙碌日程。 |
|
|
允許前進
|
allowForwarding | boolean |
指定是否可以轉送事件 |
|
|
型別
|
action | string |
指定事件提醒類型（電子郵件、通知等） |
|
|
在幾分鐘內
|
minutes | integer |
指定事件發生前或事件發生後提醒您的時間（例如：- 5 表示之前，5 表示之後） |
傳回
搜尋事件
取得所有行事曆中的事件清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
日曆
|
cuid | True | string |
指定行事曆或輸入行事曆的唯一識別碼。 |
|
開始時間
|
start | True | string |
以 yyyy-MM-ddTHH：mm：sszzz 格式指定事件開始時間。 |
|
結束時間
|
end | string |
以 yyyy-MM-ddTHH：mm：sszzz 格式指定事件結束時間。 |
|
|
搜尋文字
|
searchtext | string |
應在標題中搜尋應指定 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
搜尋
|
search | array of object |
搜尋 |
|
事件唯一識別碼
|
search.uid | string |
事件的唯一識別碼 |
|
是全天活動
|
search.isallday | boolean |
活動是否為全天活動 |
|
行事曆唯一 ID
|
search.caluid | string |
行事曆的唯一識別碼 |
|
Title
|
search.title | string |
活動名稱 |
|
型別
|
search.type | integer |
型別 |
|
Timezone
|
search.dateandtime.timezone | string |
活動時區 |
|
開始時間
|
search.dateandtime.start | string |
活動開始時間 |
|
結束時間
|
search.dateandtime.end | string |
活動結束時間 |
更新事件
更新使用者行事曆中的現有事件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
日曆
|
cuid | True | string |
指定行事曆或輸入行事曆的唯一識別碼。 |
|
Event
|
euid | True | string |
輸入事件的唯一 ID。 |
|
Title
|
title | True | string |
指定事件標題 |
|
開始時間
|
start | True | string |
以 yyyy-MM-ddTHH：mm：sszzz 格式指定事件開始時間 |
|
結束時間
|
end | True | string |
以 yyyy-MM-ddTHH：mm：sszzz 格式指定事件結束時間 |
|
Timezone
|
timezone | string |
指定活動的時區 |
|
|
顏色
|
color | string |
選擇事件顏色或指定顏色的十六進位值 |
|
|
Description
|
description | string |
指定事件的描述 |
|
|
地點
|
location | string |
指定活動的位置 |
|
|
URL
|
url | string |
指定事件的 URL |
|
|
私人
|
isprivate | boolean |
指定事件是否為私人 |
|
|
是一整天
|
isallday | boolean |
指定事件是否為全天事件。 |
|
|
電子郵件 ID
|
string |
指定出席者的電子郵件地址 |
||
|
透明度
|
transparency | integer |
指定是否應將活動新增至您的空閒/忙碌日程。 |
|
|
允許前進
|
allowForwarding | boolean |
指定是否可以轉送事件 |
|
|
型別
|
action | string |
指定事件提醒類型（電子郵件、通知等） |
|
|
在幾分鐘內
|
minutes | integer |
指定事件發生前或事件發生後提醒您的時間（例如：- 5 表示之前，5 表示之後） |
傳回
觸發程序
| 刪除事件通知 |
刪除日曆中的事件時 |
| 新事件通知 |
將事件新增至行事曆時 |
| 編輯事件通知 |
當事件更新至行事曆時 |
刪除事件通知
刪除日曆中的事件時
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
事件唯一識別碼
|
zc_data.uid | string |
事件的唯一識別碼 |
|
行事曆唯一 ID
|
zc_data.caluid | string |
行事曆的唯一識別碼 |
新事件通知
編輯事件通知
定義
單一事件解析度
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顏色
|
color | string |
十六進位的事件色彩值 |
|
Title
|
title | string |
活動名稱 |
|
持續時間
|
duration | string |
活動持續時間 |
|
事件唯一識別碼
|
uid | string |
事件的唯一識別碼 |
|
事件建立者
|
createdby | string |
建立事件的使用者 |
|
已核准
|
isApproved | boolean |
建立的事件是否已核准。 |
|
地點
|
location | string |
活動地點 |
|
URL
|
url | string |
事件的 URL |
|
事件檢視URL
|
viewEventURL | string |
事件的唯一URL。 |
|
timezone
|
dateandtime.timezone | string |
活動時區 |
|
開始時間
|
dateandtime.start | string |
活動開始時間 |
|
結束時間
|
dateandtime.end | string |
活動結束時間 |
|
事件上次修改日期
|
lastmodifiedtime | string |
上次修改事件的日期和時間 |
|
是私人的
|
isprivate | boolean |
活動是否為私人活動 |
|
出席者
|
attendees | array of object |
活動參與者 |
|
顯示名稱
|
attendees.dName | string |
出席者的顯示名稱 |
|
電子郵件 ID
|
attendees.email | string |
出席者的電子郵件地址。 |
|
出席人數
|
attendees.attendance | integer |
出席是強制性的、可選的還是不需要的。 |
|
狀態
|
attendees.status | string |
參考出席者狀態（已接受/已拒絕/暫定/需要動作） |
|
建立時間
|
createdtime_millis | string |
GMT 中的事件建立時間 |
|
通知類型
|
notifyType | integer |
根據出席者的預設通知偏好設定通知出席者有關活動的資訊。 |
|
召集人
|
organizer | string |
活動主辦單位的詳細信息。 |
|
是全天活動
|
isallday | boolean |
活動是否為全天活動 |
|
透明度
|
transparency | integer |
是否應將活動新增至忙/閒日程 |
|
修改人
|
modifiedby | string |
指修改事件的使用者。 |
|
事件標籤
|
etag | string |
參考事件標籤，以識別事件建立/修改的模式。 |
|
行事曆唯一 ID
|
caluid | string |
行事曆的唯一識別碼 |
|
允許轉發
|
allowForwarding | boolean |
事件是否可以轉發。 |
|
溫馨提示
|
reminders | array of object | |
|
提醒類型
|
reminders.action | string |
指事件提醒類型（郵件、通知、彈出視窗）。 |
|
在
|
reminders.minutes | string |
指以分鐘為單位的提醒時間。 |
單一日曆分辨率
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顏色
|
color | string |
十六進位的行事曆色彩值 |
|
Timezone
|
timezone | string |
日曆的時區 |
|
文字色彩
|
textcolor | string |
十六進位的行事曆文字顏色 |
|
Description
|
description | string |
日曆的描述 |
|
行事曆唯一 ID
|
uid | string |
行事曆的唯一識別碼 |
|
是預設值
|
isdefault | boolean |
行事曆是否為預設行事曆 |
|
包括空閒/忙碌
|
include_infreebusy | boolean |
行事曆的忙碌/忙碌狀態 |
|
名稱
|
name | string |
行事曆名稱 |
|
地位
|
status | boolean |
行事曆的狀態 |
事件通知分辨率
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顏色
|
zc_data.color | string |
十六進位的事件色彩值 |
|
Title
|
zc_data.title | string |
活動名稱 |
|
建立時間
|
zc_data.createdtime | string |
創建事件時間 |
|
使用者時區
|
zc_data.user_timezone | string |
用戶時區 |
|
活動持續時間
|
zc_data.duration | string |
活動持續時間 |
|
事件唯一識別碼
|
zc_data.uid | string |
事件的唯一識別碼 |
|
是全天活動
|
zc_data.isallday | boolean |
活動是否為全天活動 |
|
地點
|
zc_data.location | string |
活動地點 |
|
etag
|
zc_data.etag | string |
參考事件標籤，以識別事件建立/修改的模式。 |
|
行事曆唯一識別碼
|
zc_data.caluid | string |
行事曆的唯一識別碼 |
|
timezone
|
zc_data.dateandtime.timezone | string |
活動時區 |
|
開始時間
|
zc_data.dateandtime.start | string |
事件格式yyyyMMddTHHmmss的開始時間 |
|
結束時間
|
zc_data.dateandtime.end | string |
活動結束時間格式：yyyyMMddTHHmmss |
|
事件上次修改日期
|
zc_data.lastmodifiedtime | string |
上次修改事件的日期和時間 |