Google 日曆
Google 日曆可讓您組織日程並與同事和朋友分享活動。 透過 Google 的免費線上日曆，您可以輕鬆追蹤您的日程安排。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 ： - 由 21Vianet 營運的中國雲 |
| Power Automate（自動化服務） | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://calendar.google.com/calendar |
| 隱私策略 | https://policies.google.com/privacy |
要使用此集成，您需要一個 Google 帳戶。 如果您還不是用戶，請 註冊 一個新帳戶。 嘗試建立連線時，系統會提示您針對您的帳戶進行驗證。 如果您有多個帳戶，請選擇您要使用的帳戶並 登入。 驗證後，您需要授權 Microsoft 存取您的聯絡人。 點擊 允許繼續 。
您現在已準備好開始使用此整合。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
| 觸發輪詢的頻率 | 1 | 90 秒 |
動作
| 列出行事曆 |
此操作用於列出您 Google 帳戶中的所有日曆。 |
| 列出行事曆上的事件 |
此作業可用來傳回所選行事曆上任意排序事件的第一頁。 |
| 刪除活動 |
此作業可用來從行事曆中刪除事件。 |
| 取得活動 |
此作業可用來從行事曆取得特定事件的詳細資料。 |
| 建立事件 |
此作業可用來在特定行事曆上建立事件。 |
| 更新活動 |
此作業可用來更新行事曆上的現有事件。 |
列出行事曆
此操作用於列出您 Google 帳戶中的所有日曆。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
最低存取權角色
|
minAccessRole | string |
使用者檢視行事曆必須具備的最低存取權角色。 |
傳回
一或多個行事曆的清單。
- 行事曆清單
- CalendarList
列出行事曆上的事件
此作業可用來傳回所選行事曆上任意排序事件的第一頁。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendarId | True | string |
要從中獲取事件的日曆的唯一 ID。 |
|
最小時間
|
timeMin | date-time |
時間格式：yyyy-MM-ddTHH：mm：ss.fffZ （2016-07-20T08：00：00.000Z）。 |
|
|
最長時間
|
timeMax | date-time |
時間格式：yyyy-MM-ddTHH：mm：ss.fffZ （2016-07-20T09：00：59.000Z）。 |
|
|
搜尋查詢
|
q | string |
文字搜尋字詞，以在任何欄位中尋找符合這些字詞的事件 |
傳回
行事曆中的事件清單。
- 活動列表
- CalendarEventList
刪除活動
此作業可用來從行事曆中刪除事件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendarId | True | string |
要從中獲取事件的日曆的唯一 ID。 |
|
事件識別碼
|
eventId | True | string |
要更新之事件的唯一ID。 |
傳回
- response
- object
取得活動
此作業可用來從行事曆取得特定事件的詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendarId | True | string |
要從中獲取事件的日曆的唯一 ID。 |
|
事件識別碼
|
eventId | True | string |
要取得之事件的唯一ID。 |
傳回
單一行事曆事件的詳細資料。
- Event
- ResponseEvent
建立事件
此作業可用來在特定行事曆上建立事件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendarId | True | string |
要從中獲取事件的日曆的唯一 ID。 |
|
Title
|
summary | string |
活動摘要。 |
|
|
開始時間
|
start | True | date-time |
事件的 （含） 開始時間。 |
|
結束時間
|
end | True | date-time |
活動的（獨佔）結束時間。 |
|
Description
|
description | string |
事件描述。 |
|
|
地點
|
location | string |
事件的地理位置，以自由格式文字表示。 |
|
|
出席者
|
attendees | string |
輸入以逗號分隔的出席者電子郵件清單。 |
|
|
地位
|
status | string |
事件的狀態。 可能的值為「已確認」、「暫定」或「已取消」。 |
|
|
是全天
|
isAllDay | boolean |
是全天活動嗎？ |
傳回
單一行事曆事件的詳細資料。
- Event
- ResponseEvent
更新活動
此作業可用來更新行事曆上的現有事件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendarId | True | string |
要從中獲取事件的日曆的唯一 ID。 |
|
事件識別碼
|
eventId | True | string |
要取得之事件的唯一ID。 |
|
Title
|
summary | string |
活動摘要。 |
|
|
開始時間
|
start | date-time |
事件的 （含） 開始時間。 |
|
|
結束時間
|
end | date-time |
活動的（獨佔）結束時間。 |
|
|
Description
|
description | string |
事件描述。 |
|
|
地點
|
location | string |
事件的地理位置，以自由格式文字表示。 |
|
|
出席者
|
attendees | string |
輸入以逗號分隔的出席者電子郵件清單。 |
|
|
地位
|
status | string |
事件的狀態。 可能的值為「已確認」、「暫定」或「已取消」。 |
|
|
是全天
|
isAllDay | boolean |
是全天活動嗎？ |
傳回
單一行事曆事件的詳細資料。
- Event
- ResponseEvent
觸發程序
| 在日曆中新增、更新或刪除事件時 |
當在日曆中新增、更新或刪除新事件時，就會觸發此操作。 |
| 在行事曆中更新事件時 |
當行事曆中的事件更新時，會觸發此作業。 |
| 將事件新增至行事曆時 |
當新事件新增至行事曆時，會觸發此作業。 |
| 從行事曆中刪除事件時 |
當從行事曆中刪除新事件時，會觸發此作業。 |
| 活動開始時 |
此作業會在事件啟動時觸發。 |
在日曆中新增、更新或刪除事件時
當在日曆中新增、更新或刪除新事件時，就會觸發此操作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendar_id | True | string |
要從中獲取事件的日曆的唯一 ID。 |
|
展開重複性事件？
|
singleEvents | boolean |
是否要將週期性事件擴展到執行個體。 |
傳回
行事曆中的事件清單。
- 變更事件列表
- CalendarEventChangedList
在行事曆中更新事件時
當行事曆中的事件更新時，會觸發此作業。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendar_id | True | string |
要從中獲取事件的日曆的唯一 ID。 |
傳回
行事曆中的事件清單。
- 活動列表
- CalendarEventList
將事件新增至行事曆時
當新事件新增至行事曆時，會觸發此作業。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendar_id | True | string |
要從中獲取事件的日曆的唯一 ID。 |
傳回
行事曆中的事件清單。
- 活動列表
- CalendarEventList
從行事曆中刪除事件時
當從行事曆中刪除新事件時，會觸發此作業。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendar_id | True | string |
要從中獲取事件的日曆的唯一 ID。 |
傳回
行事曆中的事件清單。
- 活動列表
- CalendarEventList
活動開始時
此作業會在事件啟動時觸發。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
行事曆 ID
|
calendar_id | True | string |
要從中獲取事件的日曆的唯一 ID。 |
傳回
行事曆中的事件清單。
- 活動列表
- CalendarEventList
定義
行事曆清單
一或多個行事曆的清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
items | array of CalendarListEntry |
清單中的行事曆。 |
行事曆清單項目
單一 Google 日曆的詳細資料。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
行事曆 ID
|
id | string |
行事曆的識別碼。 |
|
總結
|
summary | string |
日曆的標題。 |
|
Description
|
description | string |
日曆的描述。 |
|
地點
|
location | string |
行事曆的地理位置，以自由格式文字表示。 |
|
時區
|
timeZone | string |
行事曆的時區。 |
行事曆事件清單
行事曆中的事件清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
items | array of ResponseEvent |
行事曆中的事件。 |
行事曆事件變更清單
行事曆中的事件清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
items | array of ResponseEventWithActionType |
變更了日曆中的事件。 |
回應事件
單一行事曆事件的詳細資料。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Title
|
summary | string |
活動摘要。 |
|
開始 Date-Time
|
start | date-time |
事件的 （含） 開始時間。 |
|
結束日期時間
|
end | date-time |
活動的（獨佔）結束時間。 |
|
Description
|
description | string |
事件描述。 |
|
地點
|
location | string |
事件的地理位置，以自由格式文字表示。 |
|
地位
|
status | string |
事件的狀態。 可能的值為「已確認」、「暫定」或「已取消」。 |
|
HTML連結
|
htmlLink | string |
清單的唯一 ID。 |
|
事件識別碼
|
id | string |
事件的不透明識別碼。 |
|
出席者
|
attendees | string |
活動的與會者。 |
|
Creator
|
creator | string |
活動的創建者。 |
|
召集人
|
organizer | string |
活動的組織者。 |
ResponseEventWithAction類型
單一行事曆事件的詳細資料，以及變更事件的動作。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
動作類型
|
actionType | string |
變更觸發程式中事件的動作類型。 |
|
Title
|
summary | string |
活動摘要。 |
|
開始 Date-Time
|
start | date-time |
事件的 （含） 開始時間。 |
|
結束日期時間
|
end | date-time |
活動的（獨佔）結束時間。 |
|
Description
|
description | string |
事件描述。 |
|
地點
|
location | string |
事件的地理位置，以自由格式文字表示。 |
|
地位
|
status | string |
事件的狀態。 可能的值為「已確認」、「暫定」或「已取消」。 |
|
HTML連結
|
htmlLink | string |
清單的唯一 ID。 |
|
事件識別碼
|
id | string |
事件的不透明識別碼。 |
|
出席者
|
attendees | string |
活動的與會者。 |
|
Creator
|
creator | string |
活動的創建者。 |
|
召集人
|
organizer | string |
活動的組織者。 |
物件
這是類型 'object'。