Power Automate で Microsoft Graph API を利用する利点

ユーザーは Microsoft Graph API の利用を煩わしく感じているかもしれませんが、この方法にはいくつかの重要な利点があります。

強化されたセキュリティ: Graph API によって提供される堅牢な認証および認可メカニズム。
より高い柔軟性: ターゲットを絞ったデータ取得のための正確なクエリとフィルタリング機能。
プラットフォームの一貫性: Microsoft の統合 API 戦略との整合性による容易な統合。
豊富なデータへのアクセス: メッセージの内容だけでなく、送信者の詳細、タイムスタンプ、添付ファイル、リアクションなどのメタデータを含む広範な情報へのアクセス。
拡張性: Microsoft Teams の新機能が利用可能になると、Graph API も継続的に進化し、それらの機能へのアクセスを提供します。例えば、標準の Power Automate Teams コネクタアクションでは利用できない、緊急度の高いメッセージの送信などが Graph API を利用することで実現可能です。

トレードオフと考慮事項

Microsoft Graph API を利用することの利点がある一方で、ユーザーが感じるように、いくつかのトレードオフと考慮事項も存在します。

複雑さの認識: HTTP 要求の使用や Graph API の構文の理解は、一部のユーザーにとって、ドロップダウンメニューや簡単な構成を持つ事前構築されたコネクタアクションを使用するよりも複雑に感じられる可能性があります。
学習コスト: ユーザーは、Graph API の概念、認証方法（Azure AD アプリケーションの登録とアクセス許可など）、および Teams メッセージエンドポイントの特定の構文について学習する必要があるかもしれません。
開発労力の増加: 「Microsoft Graph HTTP 要求の送信」アクション 1 を使用してチャットメッセージの取得を実装するには、これらの詳細を抽象化する直接的なアクションと比較して、Power Automate フロー内でより多くの手動ステップと構成が必要になります。

Power Automate コミュニティ内では、Teams チャットメッセージの取得に関連するより直接的なアクションに対する要望が表明されています
特定のメッセージ ID によるメッセージの取得や、メッセージへの返信の取得など、より粒度の細かいメッセージ操作を Power Automate コネクタ内で実現したいというニーズが存在します
現状では、Graph API を利用した回避策が議論されることが多いようです
Microsoft が将来のアップデートで、これらの一般的なユーザーシナリオに対応するために、より具体的な Teams コネクタアクションを追加する可能性も考えられます。

表 1: 関連する Power Automate Microsoft Teams コネクタのアクション

アクション名	説明
チームにメンバーを追加	Microsoft Teams にメンバーを追加します
チームを作成	新しい Microsoft Teams を作成します
チームを取得	Microsoft Teams の詳細を取得します
チャネルを作成	指定されたチーム内に新しいチャネルを作成します
メッセージを取得	この操作は、特定のチーム内のチャネルからメッセージを取得するために使用されます
チャットを作成	1 対 1 またはグループチャットを作成します
チャットを一覧表示	参加している最近のチャットを一覧表示します
メッセージの詳細を取得	チャットまたはチャネル内のメッセージの詳細を取得します
Microsoft Graph HTTP 要求を送信する	Microsoft Teams エンドポイントに対して Microsoft Graph REST API 要求を構築して呼び出します

表 2: Teams メッセージへのアクセスに関する主要な Microsoft Graph API エンドポイント

エンドポイント	説明	必要なアクセス許可 (最小特権)
GET /chats/{chat-id}/messages	特定のチャットからメッセージを取得します	Chat.Read
GET /users/{user-id}/chats/getAllMessages	指定されたユーザーが参加しているすべてのチャットからすべてのメッセージを取得します	Chat.Read
GET /teams/{team-id}/channels/{channel-id}/messages	チーム内の特定のチャネルからメッセージを取得します	ChannelMessage.Read.All