如何在Microsoft Teams应用的频道和消息层级留存自定义元数据

频道层级存储方案 #

• 首选 Graph开放扩展 直接绑定存储：无需额外搭建存储服务，元数据和频道资源永久绑定，不会随团队/频道迁移丢失。
  调用Microsoft Graph接口POST /teams/{team-id}/channels/{channel-id}/extensions即可写入自定义元数据，请求体示例：

  {
    "@odata.type": "microsoft.graph.openTypeExtension",
    "extensionName": "com.你的组织名称.业务扩展标识",
    "自定义属性1": "值1",
    "自定义属性2": "值2",
    "结构化属性": {"键1":"值1", "键2":"值2"}
  }
  

  读取时调用GET /teams/{team-id}/channels/{channel-id}?$expand=extensions即可拉取到所有绑定的自定义元数据。
• 大体积/高查询需求场景用自建存储：将团队ID_频道ID作为唯一主键，关联存储你的自定义业务属性，读取时先获取当前上下文的频道ID，再匹配查询业务库即可。

消息层级存储方案 #

• 官方原生绑定方案：和频道逻辑一致，用Graph开放扩展绑定到消息资源，调用POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/extensions写入元数据，读取时带上$expand=extensions参数即可解析。

  如果你是消息的发送方，还可以直接在自适应卡片的hidden字段中注入结构化元数据，该字段不会在Teams前端展示，仅你的应用可解析读取，无需额外调用Graph接口写入扩展。

• 自建存储方案：用频道ID_消息ID作为唯一主键关联存储业务属性，适合需要批量检索、复杂条件查询的场景，查询性能比调用Graph接口更高。

常见注意事项 #

• 单个Graph开放扩展的容量上限为2KB，超出容量的元数据必须走自建存储方案。
• 读写扩展属性需要给你的应用申请对应的Graph权限：频道层级需要ChannelSettings.ReadWrite.All权限，消息层级需要ChannelMessage.ReadWrite.All权限。

内容的提问来源于stack exchange，提问作者lakshminarayana