频道资源类型

命名空间：microsoft.graph

Teams 由频道组成，是你与团队成员的对话。 每个频道专用于特定主题、部门或项目。 频道是工作实际完成的地方 - 对整个团队开放的文本、音频和视频对话的位置、共享文件的位置以及添加标签的位置。

方法

方法	返回类型	说明
列出频道	频道集合	获取此团队中的频道列表。
创建频道	频道	通过包含显示名称和描述来新建频道。
获取频道	频道	读取频道的属性和关系。
更新频道	频道	更新频道属性。
删除频道	无	删除通道。
获取消息 Delta	chatMessage	获取频道中的增量消息。
列出频道消息	chatMessage	获取频道中的消息
获取所有频道消息	channel 集合	获取用户参与的所有频道中的所有消息。
创建频道消息发布	chatMessage	向频道发送消息。
创建回复频道消息发布	chatMessage	在频道中回复消息。
获取文件文件夹	driveItem	检索用于存储频道文件的 SharePoint 文件夹的详细信息。
列出选项卡	teamsTab	列出固定到频道的选项卡。
列出频道成员	conversationMember 集合	获取频道中的成员列表。
添加频道成员	conversationMember	向频道添加成员。 仅支持 membershipType 为 private 的 channel。
获取频道成员	conversationMember 集合	获取频道中的成员。
更新频道成员角色	conversationMember	更新频道成员的属性。 仅支持 membershipType 为 private 的频道。
删除频道成员	无	从频道中删除一个成员。 仅支持用于 private 的 channelType。
完成迁移	频道	删除频道中的迁移模式，让用户可在频道中发布和阅读消息。
列出频道中的选项卡	teamsTab	列出固定到频道的选项卡。
将选项卡添加到频道	teamsTab	将选项卡添加（固定）到频道。
获取频道中的选项卡	teamsTab	获取固定到频道的特定选项卡。
更新频道中的选项卡	teamsTab	更新频道中的选项卡的属性。
从频道中删除选项卡	无	从频道中删除（取消固定）选项卡。
预配频道电子邮件地址	provisionChannelEmailResult	为频道预配电子邮件地址。
删除频道电子邮件地址	无	删除频道的电子邮件地址。

属性

属性	类型	说明
说明	String	频道的可选文本描述。
displayName	String	在 Microsoft Teams 中呈现在用户面前的频道名称。
id	String	频道的唯一标识符。只读。
isFavoriteByDefault	Boolean	指示是否应对团队的所有成员将频道自动标记到“收藏夹”。 仅可使用“创建团队”以编程方式设置。 默认值：false。
email	String	用于向频道发送邮件的电子邮件地址。只读。
webUrl	String	将转到 Microsoft Teams 中的频道的超链接。 在 Microsoft Teams 中右键单击某个频道并选择“获取频道链接”即可获得此 URL。 应将此 URL 视为不透明的 blob，而不对其进行解析。 只读。
membershipType	channelMembershipType	通道的类型。可以在创建期间设置，并且不能更改。可能的值为：standard- Channel 继承父团队的成员列表；private- Channel 可以具有作为父团队中所有成员的子集的成员。
createdDateTime	dateTimeOffset	只读。 创建频道的时间戳。

实例属性

实例属性是具有特殊行为的属性。这些属性是临时的，并且 a) 定义服务应执行的行为或 b) 提供短期的属性值，例如过期项目的下载 URL。

属性名称	类型	说明
@microsoft. graph channelCreationMode	string	指示频道处于迁移状态，并且当前正用于迁移目的。它接受一个值：migration

注意：channelCreationMode 是采用值 migration的枚举。

有关 POST 请求示例，请参阅请求（在迁移状态下创建频道）。

关系

关系	类型	说明
messages	chatMessage 集合	频道中所有消息的集合。一种导航属性。可为 Null。
选项卡	teamsTab 集合	频道中所有选项卡的集合。一种导航属性。
members	conversationMember 集合	与频道关联的成员资格记录的集合。
filesFolder	driveItem	用于存储频道文件的位置的元数据。
operations	teamsAsyncOperation 集合	在此团队中运行过或正在运行的异步操作。

JSON 表示形式

下面是资源的 JSON 表示形式。

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