如何通过Mural API添加带元数据的Teams分组讨论室嵌入式内容？

Mural里手动粘贴URL生成的带预览的嵌入式卡片，对应API中的**link类型widget**，而非普通文本链接或给现有对象附加URL。以下是具体实现步骤：

• 核心API端点：使用POST /murals/{muralId}/widgets接口创建新元素，这是添加所有画布组件的标准入口。
• 构造请求体：指定type为link，传入你的Teams分组讨论室URL，同时可配置画布位置、卡片尺寸等属性。示例请求体：

  {
    "type": "link",
    "url": "https://teams.microsoft.com/l/meetup-join/xxx",
    "x": 100,
    "y": 100,
    "width": 300,
    "height": 200
  }
  

• 自动抓取元数据：创建link widget时，Mural会自动请求目标URL的Open Graph（OG）或其他结构化数据，生成和手动粘贴一致的预览卡片（含标题、缩略图、描述）。如果Teams分组讨论室URL本身带有OG标签，预览会自动生成；若没有，Mural会尝试抓取页面基础信息。
• 权限验证：确保你的API令牌拥有mural:widgets:create权限，且账号可访问目标画布。

额外提示 #

如果Teams分组讨论室URL无法返回合适的预览元数据，可通过中间转发页面自定义OG标签，再将中间页面URL传入API，以此实现自定义预览内容。

内容的提问来源于stack exchange，提问作者MrHinsh - Martin Hinshelwood