Power Automate クラウド フローで Graph API をよびだす

Power Automate クラウド フローではコネクタを使用してさまざまなアプリやクラウド サービス、データに接続し、操作を自動化することができます。また行いたい操作がアクションとして用意されていない場合、API をよびだすことで実現可能となることがあります。

Microsoft 365 には Graph API があり、これを利用することでMicrosoft 365 内のさまざまなデータへのアクセスや操作が可能です。Power Automate から Graph API をよびだす場合、プレミアム コネクタが利用できるなら [HTTP with Azure AD] アクションや [HTTP] アクションが利用できます。またプレミアム コネクタが利用できない Microsoft 365 プランの場合にも、Office 365 ユーザー コネクタの [HTTP 要求を送信します] アクション、Office 365 グループ コネクタの [HTTP 要求 V2 を送信する]、Office 365 Outlook コネクタの [HTTP 要求を送信します] と、いくつか利用できるアクションがあります。またそれらに加えて Teams コネクタにいつからか [Microsoft Graph HTTP 要求を送信する] アクションが追加されており、これも標準コネクタです。

標準コネクタで利用できるアクション

• 動作は委任されたアクセス許可 での実行
• Graph API での操作内容は Microsoft Graph API のリファレンス から詳細を確認可能
  Graph Explorer | Try Microsoft Graph APIs – Microsoft Graph で API を試してみることも

Teams でのアクションを利用してみる

サポートされているセグメントに第２セグメントがある場合、第２セグメントまでの指定が必要です。例えば、Teams コネクタのアクションを利用して、第1セグメントまでしか設定せずに実行してみると、

当然、実行エラーとなります。エラーメッセージの中からもこのアクションでサポートされているセグメントが確認できますね。

第1セグメント teams、第2セグメント channelsとして、第２セグメントまで指定すると、

今度は実行が成功したことが確認できます。

なおテストに利用した API は標準アクションの [チャネルの一覧表示] アクションで取得できる内容ですので、わざわざ Graph API を利用して取得する必要はありません。動作確認のため利用しています。

※ /teams/チームID/channels
チーム ID は該当チームで […] – [チームへのリンクを取得] で確認できる URL より取得できます。

例： 赤字の部分
https://teams.microsoft.com/l/team/19%3Aa988e595ba2248f8b3760ed4e1f87d8c%40thread.tacv2/conversations?groupId=ed081cee-e579-XXXX-a08e-17d5d3d4972c&tenantId=5XXXb93X-XXXX-4911-XXXX-34ba32dXXXX2

Teams コネクタには比較的多くアクションが用意されていますが、Teams 上で行えるすべての操作がアクションとして用意されているわけではありません。行いたい操作がアクションとして用意されていない場合に、Power Automate から実行するための1つの方法として知っておくとより自動化の幅を広げていただけます。

次回投稿では、Teams の [Microsoft Graph HTTP 要求を送信する] アクションを利用した例をご紹介したいと思います。