频道资源类型

命名空间:microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

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

方法

方法 返回类型 说明
列出频道 频道集合 获取此团队中的频道列表。
列出传入通道 channel 集合 获取与某 团队 共享的 频道列表。
示例 1:列出所有频道 channel 集合 获取此 团队 中的 频道列表或与此 团队(传入频道))共享的频道列表。
创建频道 频道 通过包含显示名称和描述来新建频道。
获取频道 频道 读取频道的属性和关系。
更新频道 频道 更新频道属性。
删除频道 删除通道。
获取消息 Delta chatMessage 获取频道中的增量消息。
列出频道消息 chatMessage 获取频道中的消息
获取所有频道消息 channel 集合 获取用户参与的所有频道中的所有消息。
创建频道消息发布 chatMessage 向频道发送消息。
创建回复频道消息发布 chatMessage 在频道中回复消息。
获取文件文件夹 driveItem 检索用于存储频道文件的 SharePoint 文件夹的详细信息。
列出选项卡 teamsTab 列出固定到频道的选项卡。
列出频道成员 conversationMember 集合 获取频道中的成员列表。
添加频道成员 conversationMember 向频道添加成员。 仅支持具有 privateshared membershipType 的频道。
获取频道成员 conversationMember 集合 获取频道中的成员。
更新频道成员角色 conversationMember 更新频道成员的属性。 仅支持具有 privateshared membershipType 的频道。
删除频道成员 从频道中删除一个成员。 仅支持具有 privateshared membershipType 的频道。
完成迁移 频道 删除频道中的迁移模式,让用户可在频道中发布和阅读消息。
列出频道中的选项卡 teamsTab 列出固定到频道的选项卡。
将选项卡添加到频道 teamsTab 将选项卡添加(固定)到频道。
获取频道中的选项卡 teamsTab 获取固定到频道的特定选项卡。
更新频道中的选项卡 teamsTab 更新频道中的选项卡的属性。
从频道中删除选项卡 从频道中删除(取消固定)选项卡。
预配频道电子邮件地址 provisionChannelEmailResult 为频道预配电子邮件地址。
删除频道电子邮件地址 删除频道的电子邮件地址。
删除传入频道 删除传入频道。
列出共享频道的团队 sharedWithChannelTeamInfo 集合 获取已共享指定频道的团队列表。
获取团队共享频道 Get sharedWithChannelTeamInfo 获取已共享指定频道的团队。
与团队取消共享频道 取消与团队共享频道。
列出允许的成员 conversationMember 集合 获取有权访问共享频道的团队成员的列表。
检查用户访问权限 Boolean 检查用户是否有权访问共享通道。

属性

属性 类型 说明
说明 String 频道的可选文本描述。
displayName String 在 Microsoft Teams 中呈现在用户面前的频道名称。
id String 频道的唯一标识符。只读。
isFavoriteByDefault Boolean 指示是否应对团队的所有成员将频道自动标记到“收藏夹”。 仅可使用“创建团队”以编程方式设置。 默认值:false
email String 用于向频道发送邮件的电子邮件地址。只读。
webUrl String 将转到 Microsoft Teams 中的频道的超链接。 在 Microsoft Teams 中右键单击某个频道并选择“获取频道链接”即可获得此 URL。 应将此 URL 视为不透明的 blob,而不对其进行解析。 只读。
membershipType channelMembershipType 频道的类型。 可在创建期间设置,但不可更改。 可能的值包括 standardprivateunknownFutureValueshared。 默认值为 standard。 请注意,必须使用 Prefer: include-unknown-enum-members 请求标头获取此 可进化枚举 中的以下值: shared
createdDateTime dateTimeOffset 只读。创建频道的时间戳。
moderationSettings channelModerationSettings 配置频道审核,以控制谁能在此频道中发起新帖子并回复帖子的设置。
tenantId string Azure Active Directory 租户 ID。

实例属性

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

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

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

有关 POST 请求示例,请参阅请求(在迁移状态下创建频道)

关系

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

JSON 表示形式

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

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