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