Office 365 群組

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	標準	所有 Power Automate 區域
邏輯應用程式	標準	所有 Logic Apps 區域
Power Apps	標準	所有 Power Apps 區域
Power Automate（自動化服務）	標準	所有 Power Automate 區域

連絡人​​
名稱	Office 365 群組
URL	https://learn.microsoft.com/en-us/connectors/office365groups/
Email	idcknowledgeeco@microsoft.com

連接器中繼資料
Publisher	Microsoft
網站	https://www.office.com/
隱私策略	https://privacy.microsoft.com/
類別	人工智慧;商業智慧

已知問題和限制

1. 新增 或移除群組成員時 觸發器可能會因為基礎後端服務限制而在後續回應中傳回相同的變更。 您的 Power Automate 流程或 LogicApps 應用程式必須為這類重播做好準備。 請 在此處了解更多信息。

2. 如果您看到「無法更新已啟用郵件的安全性群組和/或通訊群組清單」錯誤，請使用 Exchange 系統管理中心來管理這類群組。

3. 目前不支援具有屬性 “isAssignableToRole” 的 Microsoft Entra ID 群組。

4. 傳送 HTTP 要求/傳送 HTTP 要求 V2 （預覽） 動作。 如果您收到類似以下內容的錯誤：

• { "error": { "code": "Forbidden", "message": "" } }
• { "error": { "code": "Authorization_RequestDenied", "message": "Insufficient privileges to complete the operation." } } 那麼可能是因為此連接器的範圍集有限。 如果您的案例需要更進階的內容，請使用「HTTP」連接器或建立自訂連接器。

分頁

傳回較大結果清單的查詢需要分頁。

• Power Automate 和 Logic Apps 中的分頁功能支援 Office 365 群組連接器中的某些作業。
• 畫布應用程式資源庫控制項不支援 Office 365 群組連接器的自動分頁。 分頁必須手動實作，並快取在集合中。

支援的作業

• ListGroupMembers
• OnGroupMembershipChange
• ListGroups

若要在畫布應用程式中實作分頁體驗，請剖 @odata.nextLink 析欄位以擷取 $skipToken 值。

畫布應用程式中的手動分頁

初始負載

若要載入資料的第一頁，請在邏輯控制項的動作屬性中使用下列程式碼 （例如，頁面的 OnVisible 屬性或起始搜尋的按鈕）。

/* Call the	ListGroups operation and save response to a variable */
Set( var_response, Office365Groups.ListGroups() );

/* Parse the $skipToken value from the @odata.nextLink value in the response */
Set( var_nextLink, Last(Split( var_response.'@odata.nextLink', "=")).Result );

/* Save the response into a collection */
ClearCollect( col_groups, var_response.value );

/* Clear out the previous pages collection */
Clear( col_prevLinksData );

/* Reset page counter to 1 */
Set( var_page, 1 );

載入下一頁

/* Update page counter */
Set( var_page, var_page + 1 );

/* Save the last link in a collection */
Collect( col_prevLinksData, { 
    page: var_page, 
    link: var_nextLink 
} );

/* Get next page response */
Set( var_response, Office365Groups.ListGroups({ '$skiptoken': var_nextLink }));

/* Parse the next page's skiptoken value */
Set( var_nextLink, Last(Split( var_response.'@odata.nextLink', "=" )).Result );

/* Save the page results to the collection */
ClearCollect( col_groups, var_response.value );

然後使用資源庫控制項 （或其他資料集控制項） 屬性中的Items集合來col_groups顯示載入的專案清單。

正在建立連線

連接器支援下列驗證類型：

預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒
觸發輪詢的頻率	1	120 秒

動作

依擁有者列出已刪除的群組	列出可由擁有者還原的已刪除群組
傳送 HTTP 要求 [已棄用]	此動作已被取代。 請改用 傳送 HTTP 要求 V2 。 建構要叫用的 Microsoft Graph REST API 要求。 深入了解：https://docs.microsoft.com/en-us/graph/use-the-api
傳送 HTTP 要求 V2	建構要叫用的 Microsoft Graph REST API 要求。 支援一個區段：/groups。 深入了解：https://docs.microsoft.com/en-us/graph/use-the-api。
列出已刪除的群組	列出可還原的已刪除群組。
列出我擁有和所屬的群組	此作業會傳回您擁有及所屬之所有群組的清單。
列出我擁有的群組	此作業會傳回您擁有之所有群組的清單。
列出我擁有的群組 （V2）	此作業會傳回您擁有之所有群組的清單。
列出群組成員	此操作會傳回指定群組中所有成員的清單及其詳細資料，例如姓名、職稱、電子郵件等。您最多可以使用 Top 參數查詢 1000 個項目。 如果您需要檢索超過 1000 個值，請開啟 設定->分頁 功能並提供閾值限制。
刪除事件 （V2）	此作業會刪除行事曆中的事件。
將成員新增到群組	此作業可用來使用 UPN 將成員新增至 O365 群組。
建立群組事件 [已淘汰]	此動作已被取代。 請改用建立群組事件 （V2）。 此作業可用來在群組行事曆中建立新事件。
建立群組活動 （V2）	此作業可用來在群組行事曆中建立新事件。
從群組移除成員	此作業可用來使用 UPN 從 O365 群組移除成員。
更新群組活動	此作業可用來更新群組行事曆中的新事件。
清單群組	此作業會傳回組織中所有群組的清單。
還原已刪除的群組​​	還原最近刪除的群組

依擁有者列出已刪除的群組

傳送 HTTP 要求 [已棄用]

傳送 HTTP 要求 V2

列出已刪除的群組

列出我擁有和所屬的群組

列出我擁有的群組

列出我擁有的群組 （V2）

列出群組成員

刪除事件 （V2）

將成員新增到群組

建立群組事件 [已淘汰]

建立群組活動 （V2）

從群組移除成員

更新群組活動

清單群組

還原已刪除的群組​​

觸發程序

新增或移除群組成員時	當成員新增至指定群組或從指定群組中移除時，會觸發此作業。
當有新事件時	當新事件新增至群組行事曆時，會觸發此作業。

新增或移除群組成員時

當有新事件時

定義

SensitivityLabel中繼資料

ListGroupMembers_Response

ListOwnedGroups_Response

ListOwnedGroups_V2_Response

ListGroups_Response

CreateCalendarEvent_Response

物件無類型