最近 Power Automate の Microsoft Teams コネクタを眺めていたところ、見慣れないアクションが追加されていました。
| 英語名 | 日本語訳 |
|---|---|
| List sections | セクション一覧を取得 |
| Get a section | セクションを取得 |
| Create section | セクションを作成 |
| Update a section | セクションを更新 |
| Delete a section | セクションを削除 |
| List section items | セクション内アイテム一覧を取得 |
| Add an item to a section | セクションにアイテムを追加 |
| Move a section item | セクション内アイテムを移動 |
| Remove an item from a section | セクションからアイテムを削除 |
最初は何に使うのか全く分からなかったのですが、調べてみると Microsoft Graph の teamworkSection API に対応するアクションのようです。
Section とは？
Microsoft Graph の説明では次のように記載されています。
Represents a section in a user's Microsoft Teams chat list that organizes chats, channels, and meetings into custom or system-defined groups.
ざっくり言うと、
チャット
チャネル
会議チャット
をグループ化して整理するための機能です。
Teams のチャット画面を見ると、
お気に入り
最近のチャット
会議チャット
Teams とチャネル
ミュート
Communities
らへんですね。
List sections
まずは List sections を実行してみます。
実行すると次のような情報が取得できます。
Favorites
RecentChats
MeetingChats
TeamsAndChannels
MutedChats
EngageCommunities
さらに
"@microsoft.graph.sectionsVersion": ""1780454413222""
という値も取得できます。
後述する Create section では、この値が必要になります。
Create section
続いて Create section を試してみます。
Display Name に任意の名前を入力します。
今回は
Power Platform
という名前で作成しました。
ETag に注意
Create section では ETag が必須です。
最初は数値だけ渡していましたが、
1780454413222
ではエラーになります。
実際には
"1780454413222"
のようにダブルクォーテーション付きで渡す必要がありました。
実行後、Teams を確認すると新しいセクションが追加されました。
できた。（Teams再起動しないと出てこなかった）
List section items
セクションの中に入っているチャットなどを取得するアクションです。
最初は既存セクションを指定して試したのですが、
Listing items is not supported for system-defined sections.
というエラーになりました。
どうやら
Favorites
RecentChats
TeamsAndChannels
などのシステム定義セクションは対象外のようです。
そのため、自分で作成した userDefined セクションを指定する必要があります。
また取得できる情報は意外と少なく、
Teams 上に表示されるチャット名などは取得できませんでした。
Remove an item from a section
セクション内のアイテムを削除します。
| パラメーター | 説明 |
|---|---|
| Section ID | 対象セクションのID |
| Section Item ID | 削除対象アイテムのID |
| ETag | セクションのバージョン情報 |
ETagには、List section items で取得できるEtagを指定しました。
なお、このアクションはTeamsのチャットやチーム自体を削除するものではありません。
セクションとアイテムの関連付けを解除するためのアクションと思われます。
Graph APIの説明を見る限り、このSection機能はTeamsのチャット一覧を整理するための機能であり、チャット・チャネル・会議チャットなどを任意のセクションへ分類する用途を想定しているようです。
最後に
全部は記載してませんが、上記参考にすればAdd～も試せるんではないかと思います。
大量に追加されてたので検証してみました。