MSN 源设置和配置
设置源以确保成功引入 MSN。 本指南概述了源传送所需的格式、支持的协议、身份验证选项和最佳做法。
本文内容
支持的源格式
MSN 支持以下源类型:
- RSS 2.0
- 原子
- 媒体 RSS 的子集
- 命名空间,包括 Dublin Core 和专有Microsoft引入服务 (MI)
默认情况下,每个源必须使用 UTF-8 编码,或在 XML prolog 中指定其他有效格式。
安全源传送
- 仅支持 HTTPS 源 URL。
- 需要 TLS/SSL 加密。
- 不支持 IP 允许列表。
- URL 中包含用户名或密码的源将被拒绝。
身份验证选项
身份验证是可选的,但支持:
MSN 支持 RFC 7517 中指定的基本身份验证。 若要向源添加基本身份验证,请提供:
- 用户名
- 密码
- 保护 HTTPS 源 URL
若要将 OAuth 2.0 身份验证添加到源,请提供:
- 安全令牌服务器 URL
- Client_ID
- Grant_Type
- 范围 (可选;用于指示访问级别。此值将按原样发送)
- 受保护的源 URL
文档编码
默认情况下,MSN 使用 UTF-8 编码。 可以通过在 XML 声明中声明不同的编码来替代此代码:
<?xml version="1.0" encoding="ISO-8859-1"?>
源大小限制和错误处理
- 最大馈送大小为 10MB
- 最大映像大小为 14MB。
MSN 建议始终保持小于 30 个新鲜项的源大小,但你可以使用 ATOM 的 源分页 功能启用源的滑动窗口引入。
如果引入的内容超过三天,MSN 会自动触发升级。 如果有不同的内容年龄要求,请通过 partnerhubsupport@microsoft.com联系我们。 MSN 会重新尝试有错误的源,但如果错误仍然存在,你将收到调查的通知。 MSN 自动关闭源中长时间处于错误状态的内容引入。
扩展源元数据
可以在基于 XML 的源中扩展源词汇表和术语及其建议的前缀。 MSN 仅识别在列出的 代码示例中显式指定的元素和属性。 将忽略任何不受支持的命名空间。
| 扩展名称 | 前缀 | 命名 空间 |
|---|---|---|
| 媒体 RSS | 媒体 | http://search.yahoo.com/mrss/ |
| 都柏林核心元数据 | 直流 | http://purl.org/dc/elements/1.1/ |
| 都柏林核心条款 | dcterms | http://purl.org/dc/terms/ |
| 专有Microsoft引入服务 | 米 | http://schemas.ingestion.microsoft.com/common/ |
地理市场发布策略
MSN 合作伙伴将在他们签署合同的市场(加拿大除外)发布其内容。 加拿大合作伙伴可以选择在英语和法语市场发布其内容。
媒体文件的托管要求
支持的链接
视频文件需要以批准的格式保存,例如 MP4 文件。 如果Files来自你自己的网站或托管在 AWS 等服务器上,则允许它们使用。
不支持的链接
RSS 源不支持 Dropbox 链接、YouTube 链接等。 这是因为视频不能轻易也不会立即从这些链接中拉取,因为它们是“封闭的”。
有关更多详细信息,请参阅 源内容规范。