Microsoft Teams 应用:清单必须携带的 privacyUrl

作者 Paul Cranmer, 创始人 · 最后核实: 2026 年 10 月 · Microsoft Teams · 应用清单 developer 对象 · 开发者门户

Teams 应用验证在任何人查看你的选项卡或机器人之前,就会在清单上失败。developer 对象要求四个字段:name、websiteUrl、privacyUrl 和 termsOfUseUrl;每个网址必须以 https:// 开头(schema 接受 http://,但商店要求 https),最长 2,048 个字符。对于提交到 Teams 商店的应用,这些值必须与你在合作伙伴中心的 Teams 商店页面信息一致。本页引用 schema,并展示开发者门户与清单的交汇处。

适合谁

  • Teams 应用上传在 developer 部分清单验证失败的开发者
  • 通过合作伙伴中心提交到 Teams 商店的团队
  • 使用同一清单的 Microsoft 365 Copilot 代理构建者

不适合

  • Microsoft Store 中的 Windows 桌面应用(见合作伙伴中心属性指南)
  • Azure AD 应用注册同意屏幕

平台的要求

  • developer.privacyUrl:开发者隐私政策的 https:// 网址;必填;最多 2,048 个字符。
  • developer.termsOfUseUrl 和 developer.websiteUrl:必填,同样的限制;developer.name 最多 32 个字符;mpnId 可选。
  • 对于提交到 Teams 商店的应用,这些值必须与你的 Teams 商店页面信息一致。
  • 网址打开的页面必须公开,并描述应用如何处理它读写的 Microsoft 365 数据。

先拿到一个有效网址

Teams 应用在向导中是 API/SDK 集成(免费路径)。填写应用名称,注明它读取的 Microsoft Graph 或 Teams 数据,把在线网址粘贴到 privacyUrl 和开发者门户的应用详情中。跨清单版本保持一个网址。

获取你 Teams 应用的隐私政策网址(免费)

分步指南:粘贴你的隐私政策网址

  1. 创建隐私政策网址. 以 API/SDK 身份运行向导,填写应用名称和它触及的 Microsoft 365 数据(消息、文件、用户资料)。复制在线 HTTPS 网址。
  2. 在开发者门户中设置. dev.teams.microsoft.com → 应用 → 你的应用 → 基本信息 → 开发者信息:网站、隐私政策、使用条款。这些会写入清单的 developer 对象。
  3. 或直接编辑 manifest.json. 在 developer 对象中把 websiteUrl、privacyUrl 和 termsOfUseUrl 设为不超过 2,048 个字符的 https:// 网址,name 不超过 32 个字符。用开发者门户或 Teams Toolkit 验证。
  4. 与合作伙伴中心页面匹配. 提交到 Teams 商店时,在合作伙伴中心页面中输入相同的网址;不一致会导致验证失败。

需要找的字段名称

开发者门户 → 基本信息
开发者信息块:网站、隐私政策、使用条款。
manifest.json developer 对象
name、mpnId、websiteUrl、privacyUrl、termsOfUseUrl。
合作伙伴中心页面
Teams 商店应用必须携带相同的网址。

表单失败的常见原因

  • 商店提交中使用 http:// 网址
  • 清单和页面中的隐私网址不一致
  • 把 privacyUrl 指向公司首页

常见问题

Teams 应用清单中的 privacyUrl 是必填的吗?

是的。developer 对象要求 name、websiteUrl、privacyUrl 和 termsOfUseUrl。

网址可以多长?

最多 2,048 个字符;必须以 http:// 或 https:// 开头,商店要求 https。

清单中的网址必须与合作伙伴中心一致吗?

对于 Teams 商店应用,必须:清单的值必须与 Teams 商店页面一致。

相关内容

来源