チャネルのリソースの種類

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

チームはチャネルで構成されています。チャネルは、チームのメンバーと会話する場所です。 各チャネルは、特定のトピック、部門、プロジェクト専用です。 チャネルは、実際に作業を行う場所、チーム全体に対してテキスト、音声、ビデオによる会話を公開する場所、ファイルを共有する場所、タブを追加する場所です。

メソッド

メソッド 戻り値の型 説明
チャネルを一覧表示する channel コレクション チーム内のチャネルの一覧を取得します。
受信チャネルを一覧表示する channel コレクション チームと共有されているチャネルの一覧を取得します。
すべてのチャネルを一覧表示する channel コレクション チーム内またはこのチームと共有されているチャネル (受信チャネル) の一覧を取得します。
チャネルを作成する channel 表示名と説明を指定して新しいチャネルを作成します。
チャネルを取得する channel チャネルのプロパティとリレーションシップを読み取ります。
プライマリ チャネルを取得する channel チームの全般チャネル。
チャネルを更新する channel チャネルのプロパティを更新します。
チャネルを削除する なし チャネルを削除します。
メッセージの差分を取得する chatMessage チャネルの増分メッセージを取得します。
チャネル メッセージを一覧表示する chatMessage チャネルのメッセージを取得します。
全チャネル メッセージ取得 API が追加されました channel コレクション ユーザーが参加しているすべてのチャネルからすべてのメッセージを取得します。
保持されているすべてのチャネル メッセージを取得する chatMessage コレクション チーム内のすべてのチャネルにわたって保持されたメッセージを取得します。
チャネル メッセージの投稿を作成する chatMessage メッセージをチャネルに送信します。
チャネル メッセージの投稿への返信を作成する chatMessage チャネル内のメッセージに返信します。
ファイル フォルダーを取得する driveItem チャネルのファイルが保存されている SharePoint フォルダーの詳細情報を取得します。
タブを一覧表示する teamsTab チャネルにピン留めされているタブを一覧表示します。
チャネル メンバーを一覧表示する conversationMember コレクション チャネルのメンバーの一覧を取得します。
チャネル メンバーを追加する conversationMember チャネルにメンバーを追加します。 membershipType が private またはshared のチャネルのみサポートされます。
チャネル メンバーを取得する conversationMember コレクション チャネルのメンバーを取得します。
アーカイブ チャネル なし チャネルをアーカイブします。
アーカイブ解除チャネル なし チャネルのアーカイブを解除します。
チャネル メンバーの役割を更新する conversationMember チャネルのメンバーのプロパティを更新します。 membershipType が private またはshared のチャネルのみサポートされます。
チャネル メンバーを削除する なし チャネルからメンバーを削除します。 membershipType が private またはshared のチャネルのみサポートされます。
Complete migration channel チャネルから移行モードを削除し、ユーザーがメッセージを投稿および閲覧できるようにします。
チャネル内のリスト タブ teamsTab チャネルにピン留めされているタブを一覧表示します。
チャネルにタブを追加する teamsTab チャネルにタブを追加 (pin) します。
チャネルの [取得] タブ teamsTab チャネルにピン留めされているタブを読み取ります。
チャネルの [更新] タブ teamsTab チャネル内のタブのプロパティを更新します。
チャネルからタブを削除する なし チャネルからタブを削除 (ピン留め解除) します。
チャネルのメールアドレスをプロビジョニングする provisionChannelEmailResult チャネルのメール アドレスをプロビジョニングします。
チャネルのメールアドレスを削除する なし チャネルのメール アドレスを削除します。
受信チャネルを削除する なし チームから受信チャネル (チームと共有されているチャネル) を削除します。
チャネルを共有するチームを一覧表示する sharedWithChannelTeamInfo コレクション 指定したチャネルを共有するチームの一覧を取得します。
チャネルを共有するチームを取得する sharedWithChannelTeamInfo 指定したチャネルを共有するチームを取得します。
チームとのチャネルの共有を解除する なし チームとチャネルの共有を解除します。
許可されているメンバーを一覧表示する conversationMember コレクション 共有チャネルにアクセスできるチーム メンバーの一覧を取得します。
ユーザー アクセスを確認する ブール型 ユーザーが共有チャネルにアクセスできるかどうかを確認します。

プロパティ

プロパティ 型 説明
description String チャネルの説明テキストです (省略可能)。
displayName String Microsoft Teams のユーザーに表示されるチャネル名。 最大長は 50 文字です。
id String チャネルの一意の識別子。 読み取り専用。
isFavoriteByDefault ブール値 チームのメンバー全員に対してチャネルを「お気に入り」として自動的にマークするかどうかを示します。 チーム作成を使用して、プログラム設定だけ行えます。 既定値: false。
メール String チャネルにメッセージを送信するときのメール アドレス。 読み取り専用です。
webUrl String Microsoft Teams のチャネルへのハイパーリンク。 この URL は、Microsoft Teams でチャネルを右クリックし、[チャネルへのリンクを取得] を選択したときに提供されます。 この URL は不透明 blob として扱われる必要があり、また解析されません。 読み取り専用。
membershipType channelMembershipType チャネルの種類。 作成中に設定でき、変更できません。 使用可能な値: standard、private、unknownFutureValue、shared。 既定値は standard です。 要求ヘッダーを使用して、Prefer: include-unknown-enum-membersこの進化可能な列挙型で次の値を取得する必要があります。 shared
createdDateTime dateTimeOffset 読み取り専用です。 チャネルが作成されたときのタイムスタンプ。
moderationSettings channelModerationSettings 新しい投稿を開始できるユーザーとそのチャネルの投稿に返信できるユーザーを、そのチャネル内で制御するため、チャネルのモデレーションを構成します。
概要 channelSummary チャネルに関する概要情報 (ゲストの数、メンバー、所有者、他のテナントからのメンバーのインジケーターなど) が含まれます。 summary プロパティは、Get チャネル メソッドの句に$select表示される場合にのみ返されます。
tenantId string Microsoft Entra テナントの ID。
isArchived Boolean チャネルがアーカイブされているかどうかを示します。 読み取り専用です。

channelMembershipType 値

メンバー 説明
標準 チャネルは、親チームのメンバーの一覧を継承します。
プライベート チャネルには、親チーム上のすべてのメンバーのサブセットであるメンバーを含めることができます。
unknownFutureValue 進化可能な列挙センチネル値。 使用しないでください。
共有 メンバーは、チームに追加せずにチャネルに直接追加できます。

インスタンスの属性

インスタンスの属性は、動作が特殊なプロパティです。 これらのプロパティは一時的なものです。 サービスが実行する動作を定義するか、有効期限が切れるアイテムのダウンロード URL などの短期的なプロパティ値を指定します。

プロパティ名 種類 説明
@microsoft.graph.channelCreationMode string チャネルが移行の状態にあり、現在移行の目的で使用されていることを示します。 1 つの値 migration を受け入れます。

注: channelCreationMode は、値 migrationを受け取る列挙型です。

POST リクエストの例については、「リクエスト （移行状態でチャネルを作成する）」をご覧ください。

リレーションシップ

リレーションシップ 型 説明
messages chatMessage コレクション チャネル内のすべてのメッセージのコレクションです。 ナビゲーションのプロパティです。 Null 許容型。
tabs teamsTab コレクション チャネル内のすべてのタブのコレクションです。 ナビゲーションのプロパティです。
members conversationMember コレクション チャネルに関連付けられているメンバーシップ レコードのコレクション。
filesFolder driveItem チャネルのファイルが保存されている場所のメタデータ。
操作 teamsAsyncOperation コレクション このチームで実行済みまたは実行中の非同期操作です。
sharedWithTeams sharedWithChannelTeamInfo コレクション チャネルが共有されているチームのコレクション。

JSON 表記

次の JSON 表現は、リソースの種類を示しています

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)",
  "isFavoriteByDefault": true,
  "email": "string",
  "webUrl": "string",
  "membershipType": "String",
  "isArchived": false,
  "createdDateTime": "string (timestamp)",
  "moderationSettings": { "@odata.type": "microsoft.graph.channelModerationSettings" }
}

関連コンテンツ