チャネルのリソースの種類channel resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

チームはチャネルで構成されています。チャネルは、チームのメンバーと会話する場所です。Teams are made up of channels, which are the conversations you have with your teammates. 各チャネルは、特定のトピック、部門、プロジェクト専用です。Each channel is dedicated to a specific topic, department, or project. チャネルは、実際に作業を行う場所、チーム全体に対してテキスト、音声、ビデオによる会話を公開する場所、ファイルを共有する場所、タブを追加する場所です。Channels are where the work actually gets done - where text, audio, and video conversations open to the whole team happen, where files are shared, and where tabs are added.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
チャネルを一覧表示するList channels channel コレクションchannel collection このチーム内のチャネルの一覧を取得します。Get the list of channels in this team.
チャネルを作成するCreate channel channelchannel 表示名と説明を指定して新しいチャネルを作成します。Create a new channel by including the display name and description.
チャネルを取得するGet channel channelchannel チャネルのプロパティとリレーションシップを読み取ります。Read properties and relationships of the channel.
チャネルを更新するUpdate channel channelchannel チャネルのプロパティを更新します。Update properties of the channel.
チャネルを削除するDelete channel なしNone チャネルを削除します。Delete a channel.
メッセージの差分を取得するGet message delta chatMessagechatMessage チャネルの増分メッセージを取得します。Get incremental messages in a channel.
チャネル メッセージを一覧表示するList channel messages chatMessagechatMessage チャネルのメッセージを取得します。Get messages in a channel
チャネル メンバーを一覧表示するList channel members conversationMember コレクションconversationMember collection チャネルのメンバーを一覧表示します。List the members of a channel.
チャネル メンバーを取得するGet channel member conversationMemberconversationMember チャネルのメンバーを取得します。Get a member of a channel.
チャネル メンバーを追加するAdd channel member conversationMemberconversationMember チャネルにメンバーを追加します。Add a member to a channel. privatechannelType のみサポートされます。Only supported for channelType of private.
チャネル メンバーを更新するUpdate channel member conversationMemberconversationMember チャネルのメンバーを更新します。Update a member of a channel. privatechannelType のみサポートされます。Only supported for channelType of private.
チャネル メンバーを削除するDelete channel member conversationMemberconversationMember チャネルのメンバーを削除します。Delete a member of a channel. privatechannelType のみサポートされます。Only supported for channelType of private.
チャネルで chatMessage を作成するCreate chatMessage in a channel chatMessagechatMessage メッセージをチャネルに送信します。Send a message to a channel.
チャネルでの chatMessage 返信の作成Create chatMessage reply in a channel chatMessagechatMessage チャネル内のメッセージに返信します。Reply to a message in a channel.
タブを一覧表示するList tabs teamsTabteamsTab チャネルにピン留めされているタブを一覧表示します。Lists tabs pinned to a channel.
タブを取得するGet tab teamsTabteamsTab チャネルにピン留めされているタブを読み取ります。Reads a tab pinned to a channel.
タブを追加するAdd tab teamsTabteamsTab タブをチャネルに追加 (ピン留め) します。Adds (pins) a tab to a channel.
タブを削除するRemove tab なしNone チャネルからタブを削除します (ピン留めを外します)。Removes (unpins) a tab from a channel.
タブを更新するUpdate tab teamsTabteamsTab タブのプロパティを更新します。Updates the tab properties.
ファイル フォルダーを取得するGet files folder driveItemdriveItem チャネルのファイルが保存されている SharePoint フォルダーの詳細情報を取得します。Retrieves the details of the SharePoint folder where the files for the channel are stored.

プロパティProperties

プロパティProperty Type 説明Description
descriptiondescription StringString チャネルの説明テキストです (省略可能)。Optional textual description for the channel.
displayNamedisplayName StringString Microsoft Teams でユーザーに対して表示されるチャネルの名前。Channel name as it will appear to the user in Microsoft Teams.
idid StringString チャネルの一意の識別子。The channel's unique identifier. 読み取り専用。Read-only.
isFavoriteByDefaultisFavoriteByDefault ブール値Boolean チームのメンバー全員に対してチャネルを「お気に入り」として自動的にマークするかどうかを示します。Indicates whether the channel should automatically be marked 'favorite' for all members of the team. 既定値: falseDefault: false.
メールemail StringString チャネルにメッセージを送信するときのメール アドレス。The email address for sending messages to the channel. 読み取り専用です。Read-only.
webUrlwebUrl StringString Microsoft Teams のチャネルに移動するハイパーリンク。A hyperlink that will go to the channel in Microsoft Teams. これは、Microsoft Teams でチャネルを右クリックし、[チームへのリンクを取得] を選択すると作成される URL です。This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. この URL は不透明 blob として扱われる必要があり、また解析されません。This URL should be treated as an opaque blob, and not parsed. 読み取り専用。Read-only.
membershipTypemembershipType channelMembershipTypechannelMembershipType チャネルの種類。The type of the channel. 作成中に設定でき、変更できません。Can be set during creation and cannot be changed. 既定値: 標準。Default: standard.

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
messagesmessages chatMessage コレクションchatMessage collection チャネル内のすべてのメッセージのコレクションです。A collection of all the messages in the channel. ナビゲーションのプロパティです。A navigation property. Null 許容型です。Nullable. 現在この API では読み取りだけがサポートされていますが、最終的にはメッセージの作成もサポートされる予定です。Currently this API only supports reading but will eventually support writing messages too.
tabstabs teamsTab コレクションteamsTab collection チャネル内のすべてのタブのコレクションです。A collection of all the tabs in the channel. ナビゲーションのプロパティです。A navigation property.
membersmembers conversationMember コレクションconversationMember collection チャネルに関連付けられているメンバーシップ レコードのコレクション。A collection of membership records associated with the channel.
driveItemdriveItem driveItemdriveItem チャネルのファイルが保存されている場所のメタデータ。Metadata for the location where the channel's files are stored.

JSON 表記JSON representation

リソースの JSON 表記を次に示します。The following is a JSON representation of the resource.

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)",
  "isFavoriteByDefault": true,
  "email": "string",
  "webUrl": "string",
  "membershipType": "channelMembershipType"
}