esmDevelopers
URL API
esm API
JSプラグイン
esm linkage
URL API
esm API
JSプラグイン
esm linkage
  • Microsoft Teams(認可コード)>チャンネル情報を一覧取得 GET

Microsoft Teams(認可コード)>チャンネル情報を一覧取得 GET

アクション概要

このアクションは、指定されたチーム内のチャンネルの一覧を取得します。

入力値定義

作成

フィールド名パラメータ名必須説明
Team IDteam-id〇チャンネル情報を取得したいチームのIDです。
Top$top取得するチャンネルの最大数を指定します。
Skip$skipスキップするチャンネルの数を指定します。ページネーションに使用します。

参照

項目説明
参照ステップワークフロー内にあるアクションまたはユーティリティから参照先ステップを設定します。
参照する出力参照する値をリストから設定します。

設定例

フィールド名設定値
Team ID[チームのIDをここに設定]
Top20

出力値

フィールド名説明
idチャンネルの一意のIDです。
displayNameチャンネルの表示名です。
descriptionチャンネルの説明です。
isFavoriteByDefaultこのチャンネルがデフォルトでお気に入りかどうかを示します。

よくあるエラーと対処法

エラーコード原因対応策
404 Not Foundhannel_not_found指定されたTeam IDが見つかりません。Team IDが正しいか確認してください。
403 Forbidden指定されたチームのチャンネルを表示する権限がありません。Microsoft Teamsの管理者またはIT部門に連絡し、適切なAPIアクセス権限が付与されているか確認してください。

補足

このアクションは、特定のチーム内のチャンネル情報を取得する際に便利です。
例えば、チーム内のすべてのチャンネルにメッセージを送信する前に、チャンネルの一覧を取得するために使用できます。

参考リンク

  • Microsoft Graph API: List channels