频道资源类型

命名空间：microsoft.graph

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

方法

方法 返回类型 说明
列出频道 频道集合 获取此团队中的频道列表。
列出传入通道 channel 集合 获取传入 频道（与团队共享的频道）列表。
示例 1：列出所有频道 channel 集合 获取此团队中的频道列表或与此团队（传入频道)）共享的频道列表。
创建频道 频道 通过包含显示名称和描述来新建频道。
获取频道 频道 读取频道的属性和关系。
获取主通道 频道 团队的常规频道。
更新频道 频道 更新频道属性。
删除频道 无 删除通道。
列出频道消息 chatMessage 获取频道中的消息
获取所有频道消息 channel 集合 获取用户参与的所有频道中的所有消息。
获取所有保留的频道消息 chatMessage 集合 获取团队中所有频道的所有保留消息。
创建频道消息发布 chatMessage 向频道发送消息。
创建回复频道消息发布 chatMessage 在频道中回复消息。
获取文件文件夹 driveItem 检索用于存储频道文件的 SharePoint 文件夹的详细信息。
列出选项卡 teamsTab 列出固定到频道的选项卡。
列出频道成员 conversationMember 集合 获取频道中成员的列表，包括标准频道、专用频道和共享频道的直接成员。
列出所有成员 conversationMember 集合 获取频道中所有成员的列表。
添加频道成员 conversationMember 向频道添加成员。 仅支持具有 private 或 sharedmembershipType 的频道。
获取频道成员 conversationMember 集合 获取频道中的成员。
存档通道 无 存档团队中的频道。
非存档通道 无 还原团队中的存档频道。
更新频道成员角色 conversationMember 更新频道成员的属性。 仅支持具有 private 或 sharedmembershipType 的频道。
删除频道成员 无 从频道中删除一个成员。 仅支持具有 private 或 sharedmembershipType 的频道。
开始迁移 频道 通过在现有 通道中启用迁移模式，开始迁移外部消息。
完成迁移 频道 在现有 通道 或新通道上完成迁移。
列出频道中的选项卡 teamsTab 列出固定到频道的选项卡。
将选项卡添加到频道 teamsTab 将选项卡添加（固定）到频道。
获取频道中的选项卡 teamsTab 获取固定到频道的特定选项卡。
更新频道中的选项卡 teamsTab 更新频道中的选项卡的属性。
从频道中删除选项卡 无 从频道中删除（取消固定）选项卡。
在频道中列出应用 teamsApp 集合 获取团队中指定频道中已启用的应用列表。
在频道中获取应用 teamsApp 在团队中的指定频道中获取已启用的应用。
将应用添加到频道 无 添加一个 teamsApp，用于在团队中的指定频道中启用应用。
从频道中删除应用 无 删除在团队内指定频道中禁用应用的teamsApp。
预配频道电子邮件地址 provisionChannelEmailResult 为频道预配电子邮件地址。
删除频道电子邮件地址 无 删除频道的电子邮件地址。
删除传入频道 无 从团队删除传入频道（从团队共享的频道）。
列出共享频道的团队 sharedWithChannelTeamInfo 集合 获取已共享指定频道的团队列表。
获取团队共享频道 Get sharedWithChannelTeamInfo 获取已共享指定频道的团队。
与团队取消共享频道 无 通过删除相应的 sharedWithChannelTeamInfo 资源，取消与团队共享频道。
列出允许的成员 conversationMember 集合 获取可以访问共享的频道的 conversationMembers 列表。
检查用户访问权限 Boolean 确定 用户 是否有权访问共享 频道。

属性

属性 类型 说明
createdDateTime dateTimeOffset 只读。 创建频道的时间戳。
description String 频道的可选文本描述。
displayName String 在 Microsoft Teams 中呈现在用户面前的频道名称。 最大长度为 50 个字符。
email String 用于向频道发送邮件的电子邮件地址。 只读。
id String 频道的唯一标识符。 只读。
isArchived Boolean 指示通道是否已存档。 只读。
isFavoriteByDefault Boolean 指示是否应将频道标记为建议团队的所有成员在其频道列表中显示。 注意： 所有推荐的频道都会自动显示在教育版和一线员工用户的频道列表中。 只能通过 Create team 方法以编程方式设置 属性。 默认值为 false。
layoutType channelLayoutType 通道的布局类型。 可以在创建期间设置它，并在以后更新。 可能的值包括 post、chat、unknownFutureValue。 默认值为 post。 具有布局的 post 频道使用传统的回复后对话格式，具有聊天布局的频道提供类似于聊天的线程体验，类似于群组聊天。
membershipType channelMembershipType 频道的类型。 可在创建期间设置，但不可更改。 可能的值包括 standard、private、unknownFutureValue、shared。 默认值为 standard。 使用 Prefer: include-unknown-enum-members 请求标头获取此 可演变枚举中的以下成员： shared。
migrationMode migrationMode 指示通道是否处于迁移模式。 此值 null 适用于从未进入迁移模式的通道。 可能的值包括 inProgress、completed、unknownFutureValue。
originalCreatedDateTime dateTimeOffset 通道的原始创建时间的时间戳。 如果通道从未进入迁移模式，则值为 null 。
tenantId string Microsoft Entra租户的 ID。
webUrl String 将转到 Microsoft Teams 中的频道的超链接。 在 Microsoft Teams 中右键单击某个频道并选择“获取频道链接”即可获得此 URL。 应将此 URL 视为不透明的 blob，而不对其进行解析。 只读。
摘要 channelSummary 包含有关通道的摘要信息，包括所有者、成员、来宾的数量，以及来自其他租户的成员的指示器。 只有在 Get 通道方法的 子句中$select指定了摘要属性时，才会返回该属性。

channelMembershipType 值

成员 说明
标准 通道继承父团队的成员列表。
私人 通道可以具有成员，这些成员可以是父团队上所有成员的子集。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。
shared 可以直接将成员添加到频道，而无需将他们添加到团队。

migrationMode 值

成员 说明
inProgress 频道或聊天进入迁移模式。
完成 频道或聊天已退出迁移模式。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

channelLayoutType 值

成员 说明
帖子 传统的回复后对话格式。 帖子以结构化格式显示，回复嵌套在原始帖子下。 表示默认布局类型。
聊天 类似于群聊的类似聊天的线程处理体验。 消息显示在支持特定主题的线程对话的连续流中。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

实例属性

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

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

注意： channelCreationMode 是一个枚举，它采用值 migration。

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

关系

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

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "email": "String",
  "id": "String (identifier)",
  "isArchived": "Boolean",
  "isFavoriteByDefault": "Boolean",
  "layoutType": "String",
  "membershipType": "String",
  "migrationMode": "String",
  "originalCreatedDateTime": "String (timestamp)",
  "webUrl": "String"
}

相关内容

  • Last updated on