概要
チャネルリソースはTeamsのチャネル情報を取得した際に使用するプロパティ
プロパティ
| プロパティ | 型 | 利用 | C#クラス | テーブル列名 | 説明 |
|---|---|---|---|---|---|
| id | String | 〇 | チャネルの一意の識別子。 読み取り専用。 | ||
| createdDateTime | dateTimeOffset | 〇 | 読み取り専用です。 チャネルが作成されたときのタイムスタンプ。 | ||
| displayName | String | 〇 | Microsoft Teams でユーザーに対して表示されるチャネルの名前。 最大長は 50 文字です。 | ||
| 説明 | String | 〇 | チャネルの説明テキストです (省略可能)。 | ||
| isFavoriteByDefault | ブール値 | 〇 | isFavoriteByDefault が true に設定されている場合、そのチャネルはチームのすべてのメンバーに対して自動的に表示されます。チームのチャネル一覧にそのチャネルがデフォルトで含まれるようになります。 初期値はFalse。 |
||
| メール | String | 〇 | チャネルにメッセージを送信するときのメール アドレス。 読み取り専用です。 | ||
| tenantId | string | 〇 | Microsoft Entra テナントの ID。 | ||
| webUrl | String | 〇 | Microsoft Teams のチャネルに移動するハイパーリンク。 これは、Microsoft Teams でチャネルを右クリックし、[チームへ のリンクを取得] を選択すると作成される URL です。 この URL は不透明 blob として扱われる必要があり、また解析されません。 読み取り専用です。 |
||
| membershipType | channelMembershipType | 〇 | チャネルの種類。 作成中に設定でき、変更できません。 使用可能な値: standard、private、unknownFutureValue、shared。 既定値は standard です。 Prefer: include-unknown-enum-members要求ヘッダーを使用して、この進化可能な列挙型で次の値を取得します:shared。 |
||
| isArchived | Boolean | 〇 | チャネルがアーカイブされているかどうかを示します。 読み取り専用です。 | ||
| 概要 | channelSummary | – | 所有者、メンバー、ゲストの数、他のテナントのメンバーのインジケーターなど、チャネルに関する概要情報が含まれます。 summary プロパティは、Get チャネル メソッドの $select 句で指定されている場合にのみ返されます。 |
メソッド
| メソッド | 戻り値の型 | CompreView 使用 |
説明 |
|---|---|---|---|
| チャネルを一覧表示する | channel コレクション | 〇 | チーム内のチャネルの一覧を取得します。 |
| 受信チャネルを一覧表示する | channel コレクション | 受信チャネル (チームと共有されているチャネル) の一覧を取得します。 | |
| すべてのチャネルを一覧表示する | channel コレクション | チーム内またはこのチームと共有されているチャネル (受信チャネル) の一覧を取得します。 | |
| チャネルを作成する | channel | 表示名と説明を指定して新しいチャネルを作成します。 | |
| チャネルを取得する | channel | チャネルのプロパティとリレーションシップを読み取ります。 | |
| プライマリ チャネルを取得する | channel | チームの全般チャネル。 | |
| チャネルを更新する | channel | チャネルのプロパティを更新します。 | |
| チャネルを削除する | なし | チャネルを削除します。 | |
| チャネル メッセージを一覧表示する | chatMessage | チャネルのメッセージを取得します。 | |
| 全チャネル メッセージ取得 API が追加されました | channel コレクション | ユーザーが参加しているすべてのチャネルからすべてのメッセージを取得します。 | |
| 保持されているすべてのチャネル メッセージを取得する | chatMessage コレクション | チーム内のすべてのチャネルにわたって保持されているすべてのメッセージを取得します。 | |
| チャネル メッセージの投稿を作成する | chatMessage | メッセージをチャネルに送信します。 | |
| チャネル メッセージの投稿への返信を作成する | chatMessage | チャネル内のメッセージに返信します。 | |
| ファイル フォルダーを取得する | driveItem | チャネルのファイルが保存されている SharePoint フォルダーの詳細情報を取得します。 | |
| タブを一覧表示する | teamsTab | チャネルにピン留めされているタブを一覧表示します。 | |
| チャネル メンバーを一覧表示する | conversationMember コレクション | チャネルのメンバーの一覧を取得します。 | |
| すべてのメンバーを一覧表示する | conversationMember コレクション | チャネル内のすべての メンバー の一覧を取得 します。 | |
| チャネル メンバーを追加する | conversationMember | チャネルにメンバーを追加します。 membershipType が private またはshared のチャネルのみサポートされます。 |
|
| チャネル メンバーを取得する | conversationMember コレクション | チャネルのメンバーを取得します。 | |
| チャネルをアーカイブする | なし | チーム内のチャネルをアーカイブします。 | |
| チャネルのアーカイブを解除する | なし | アーカイブされたチャネルをチームに復元します。 | |
| チャネル メンバーの役割を更新する | conversationMember | チャネルのメンバーのプロパティを更新します。 membershipType が private またはshared のチャネルのみサポートされます。 |
|
| チャネル メンバーを削除する | なし | チャネルからメンバーを削除します。 membershipType が private またはshared のチャネルのみサポートされます。 |
|
| Complete migration | channel | チャネルから移行モードを削除し、ユーザーがメッセージを投稿および閲覧できるようにします。 | |
| チャネル内のリスト タブ | teamsTab | チャネルにピン留めされているタブを一覧表示します。 | |
| チャネルにタブを追加する | teamsTab | チャネルにタブを追加 (pin) します。 | |
| チャネルの [取得] タブ | teamsTab | チャネルにピン留めされているタブを読み取ります。 | |
| チャネルの [更新] タブ | teamsTab | チャネル内のタブのプロパティを更新します。 | |
| チャネルからタブを削除する | なし | チャネルからタブを削除 (ピン留め解除) します。 | |
| チャネルのメールアドレスをプロビジョニングする | provisionChannelEmailResult | チャネルのメール アドレスをプロビジョニングします。 | |
| チャネルのメールアドレスを削除する | なし | チャネルのメール アドレスを削除します。 | |
| 受信チャネルを削除する | なし | チームから受信チャネル (チームと共有されているチャネル) を削除します。 | |
| チャネルを共有するチームを一覧表示する | sharedWithChannelTeamInfo コレクション | 指定したチャネルと共有されているチームの一覧を取得します。 | |
| チャネルを共有するチームを取得する | sharedWithChannelTeamInfo | 指定したチャネルと共有されているチームを取得します。 | |
| チームとのチャネルの共有を解除する | なし | 対応する sharedWithChannelTeamInfo リソースを削除して、チャネルとチームの共有を解除します。 | |
| 許可されているメンバーを一覧表示する | conversationMember コレクション | 共有チャネルにアクセスできる conversationMembers の一覧を取得します。 | |
| ユーザー アクセスを確認する | ブール型 | ユーザーが共有チャネルにアクセスできるかどうかを判断します。 |
参考文献
チャネルは、チーム内の chatMessages のコレクションです。