MSN 源项元数据要求
此页面概述了 MSN 源中文章、视频、库和图像的必需和可选元数据字段。 使用本指南可确保项满足最低引入标准，并支持跨 MSN 的高质量呈现。
源项要求适用于所有市场和所有发布者，但某些市场或业务案例可能需要其他字段。 如有其他源项要求，请通过 partnerhubsupport@microsoft.com 联系我们。
本文内容
文章
项目必须具有唯一 ID、 标题、 发布日期、 正文和 链接 URL。 所有其他元数据都是可选的。
必填字段
| 字段名称 | 说明 |
|---|---|
| 唯一 ID | 持久 (不变) GUID，用于唯一标识源中的项目。 它也可以是文章的完整唯一 URL。 此值对于来自同一合作伙伴的所有内容项必须是唯一的。 |
| 标题 | 内容项标题必须超过 20 个字符，但不超过 150 个字符，除非还提供了简短标题。 可以删除超过 150 个字符且没有短标题的标题。 不允许使用 HTML 标记。 |
| 正文 | 内容项正文。 RSS 和 Atom 格式都允许使用 HTML。 |
| 发布日期 | 发布时间。 日期必须处于过去且小于 365 天，否则不会引入该日期。 支持的日期格式为 RFC 822 是和 RFC 3339。 |
| 链接 (Web URL) | 用于在发布者网站上唯一查找源项的 URL。 此链接可用于社交网络共享，具体取决于你的合同。 |
可选字段，但建议
| 字段名称 | 说明 |
|---|---|
| 抽象 | 必须采用纯文本格式。 不支持 HTML。 |
| 更新日期 | 如果提供此日期，它将用于标识此源项目中的内容是否是具有指定 No ID 的原始引入文档的较新版本。否则，“发布日期”将用于此目的。 |
| 有效期 | 源项将在指定日期之前从 MSN 合作伙伴中心后端和前端中删除。 如果未提供此值，内容项将在引入后的 365 天内过期。 到期日期必须超过 2 小时。 |
| 字幕 | 一个解释性或备用标题，用于在促销卡片的标题下方显示。 |
| 短标题 | 在紧凑设置（如促销卡）上显示内容时，将使用“短标题”值（也称为“Web 标题”。 此字段中的值应为 54 个字符或更少。 |
| 作者 | 文章的作者或参与者。 |
| 映像 () | 如果引用了图像，则必须根据图像必填字段部分指定某些元数据。 虽然图像是可选的，但自动发布需要它们。 |
| 相关链接 | 可以将相关链接指定为与内容一起显示。 每篇文章必须至少提供三个相关链接。 |
| 类别 | 指定与内容片段相关的标记。 使用 <category> 元素在 RSS 和 ATOM 中添加标记。 |
| 关键字 | 每个内容项的上下文关键字。 可以在用逗号分隔的单个节点中指定多个关键字。 若要在 RSS 或 ATOM 中指定此值，则无需使用 Media RSS <media:keywords> 元素。 |
| 嵌入式幻灯片放映 | 文章可能具有嵌入的幻灯片放映。 有关更多详细信息，请参阅 幻灯片放映示例 。 |
| 嵌入式视频 | 文章可能具有嵌入的视频。 有关更多详细信息，请参阅 视频示例 。 |
| SubscriptionProductType | 可以通过订阅模型访问某些源项。 若要在 RSS /ATOM 源中指定高级付费源项，需要使用 <mi:SubscriptionProductType> 元素。 例如 。 <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType> |
幻灯片
幻灯片放映必须具有 标题、 唯一 ID 和 发布日期。 此外，它必须包含多张幻灯片， (两张 (2 张) 是最少的幻灯片数，200 张是每张幻灯片由一个图像对象构成的最大) 。 检测更新的项目遵循用于文章的相同算法。
必填字段
| 字段名称 | 说明 |
|---|---|
| 唯一 ID | 持久 (不变) GUID，用于唯一标识幻灯片放映。 它也可以是发布者网站上幻灯片放映的完整唯一 URL。 此值对于来自同一发布者的所有内容项必须是唯一的。 |
| 标题 | 内容项标题必须超过 20 个字符，但不超过 150 个字符，除非还提供了简短标题。 可以删除超过 150 个字符且没有短标题的标题。 不允许使用 HTML 标记。 |
| 发布日期 | 发布时间。 日期必须处于过去且小于 365 天，否则不会引入该日期。 支持的日期格式为 RFC 822 是和 RFC 3339。 |
| 幻灯片 | 每个幻灯片放映都必须包含一组幻灯片 (图像) 。 幻灯片放映中的每张幻灯片都是从相应的图像元数据构造的;尤其是：
|
| 链接 (Web URL) | 用于在发布者网站上唯一查找源项的 URL。 此链接可用于社交网络共享，具体取决于合同。 |
可选字段，但建议
| 字段名称 | 说明 |
|---|---|
| 抽象 | 幻灯片放映的说明。 (如果缺少幻灯片标题) 必须为纯文本，则为必需。 不支持 HTML。 |
| 更新日期 | 如果提供此日期，它将用于标识此源项目中的内容是否是具有指定 No ID 的原始引入文档的较新版本。否则，“发布日期”将用于此目的。 |
| 有效期 | 源项将在指定日期之前从 MSN 合作伙伴中心后端和前端中删除。 如果未提供此值，内容项将在引入后的 365 天内过期。 到期日期必须超过 2 小时。 |
| 字幕 | 一个解释性或备用标题，用于在促销卡片的标题下方显示。 |
| 短标题 | 在紧凑设置（如促销卡）上显示内容时，使用“短标题”值（也称为“Web 标题”。 此字段中的值应为 54 个字符或更少。 |
| 作者 | 幻灯片的作者或参与者。 |
| 相关链接 | 可以将相关链接指定为与内容一起显示。 每篇文章必须至少提供三个相关链接。 |
| 类别 | 指定与内容片段相关的标记。 使用 <category> 元素在 RSS 和 ATOM 中添加标记。 |
| 关键字 | 每个内容项的上下文关键字。 可以在用逗号分隔的单个节点中指定多个关键字。 若要在 RSS 或 ATOM 中指定此值，则无需使用 Media RSS <media:keywords> 元素。 |
| SubscriptionProductType | 可以通过订阅模型访问某些源项。 若要在 RSS /ATOM 源中指定高级付费源项，需要使用 <mi:SubscriptionProductType> 元素。 例如 。 <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType> |
视频
仅视频源中指定的视频必须具有 唯一 ID、 URL、 发布日期、 标题、 归属和 隐藏字幕 (目标市场) 法律要求。 如果未提供唯一 ID，或者视频嵌入到文章中，则 URL 用作标识符。
必填字段
| 字段名称 | 说明 |
|---|---|
| 唯一 ID | 持久 (不变) GUID，用于唯一标识视频。 它也可以是发布者网站上视频的完整唯一 URL。 此值对于来自同一发布者的所有内容项必须是唯一的。 |
| 标题 | 视频标题。 这用作页眉/标题。 |
| 发布日期 | 发布时间。 日期必须处于过去且小于 365 天，否则不会引入该日期。 |
| 视频 URL | 视频源文件位置。 URL 必须是绝对的，并且所有形式的相对 URL 都将失败引入。 |
| 链接 (Web URL) | 用于在发布者网站上唯一查找源项的 URL。 此链接可用于社交网络共享，具体取决于合同。 |
| 归 因 | 视频的版权信息。 |
| 隐藏式字幕 | 隐藏式字幕随视频持续时间一起显示在视频上。 只有在目标市场受法律授权时才需要。 |
| 持续时间 | 仅 3PP 视频需要。 |
| 缩略图 () |
仅 3PP 视频需要。 要链接到视频的缩略图。 可在此处使用所有图像属性，但缩略图只需要 URL。 建议在以下位置使用单个 JPG 映像：
|
可选字段，但建议
| 字段名称 | 说明 |
|---|---|
| 摘要) 说明 ( | 要显示在视频下的文本。 |
| 持续时间 | 视频的持续时间（以秒为单位）。 (3PP 视频) 必需。 |
| 更新日期 | 如果提供此日期，它将用于标识此源项目中的内容是否是具有指定 No ID 的原始引入文档的较新版本。否则，“发布日期”将用于此目的。 |
| 有效期 | 源项将在指定日期之前从 MSN 合作伙伴中心后端和前端中删除。 如果未提供此值，内容项将在引入后的 365 天内过期。 到期日期必须超过 2 小时。 |
| 字幕 | 一个解释性或备用标题，用于在促销卡片的标题下方显示。 |
| 短标题 | 在紧凑设置（如促销卡）上显示内容时，将使用“短标题”值（也称为“Web 标题”。 此字段中的值应为 54 个字符或更少。 |
| 作者 | 视频的作者或参与者。 |
| 缩略图 () | 要链接到视频的缩略图。 可在此处使用所有图像属性，但缩略图只需要 URL。 建议在以下位置使用单个 JPG 映像：
|
| 隐藏式字幕 | 隐藏式字幕随视频持续时间一起显示在视频上。 只有在目标市场受法律授权时才需要。 |
| 相关链接 | 可以将相关链接指定为与内容一起显示。 每篇文章必须至少提供三个相关链接。 |
| 类别 | 指定与内容片段相关的标记。 使用 <category> 元素在 RSS 中添加标记 |
| 关键字 | 每个内容项的上下文关键字。 可以在用逗号分隔的单个节点中指定多个关键字。 若要在 RSS 或 ATOM 中指定此值，则无需使用 Media RSS <media:keywords> 元素。 |
| SubscriptionProduct 类型 | 可以通过订阅模型访问某些源项。 若要在 RSS /ATOM 源中指定高级付费源项，需要使用 <mi:SubscriptionProductType> 元素。 例如 。 <mi:SubscriptionProductType>Premium</mi:SubscriptionProductType> |
图像
文章中的全尺寸图像必须具有 有效的 URL。 幻灯片放映中的图像必须具有 标题 和 URL。 视频、相关链接或全尺寸图像的缩略图只需要 URL。 自动发布需要映像联合权限。
必填字段
| 字段名称 | 说明 |
|---|---|
| URL | 图像的源位置。 URL 必须是绝对的，所有形式的“是”相对 URL 将失败引入。 |
| 标题 | 图像标题。 此外，用作沿图像显示的描述文字。 仅当图像用作幻灯片放映中的幻灯片时才需要。 |
| 映像联合权限 |
仅自动发布需要。 如果你有映像的联合权限： 案例 1：此字段将默认为 True，因为大多数发布者对其图像具有联合权限。 如果没有图像的联合权限，有两个选项： 案例 2：除非可以在案例 3 中提供所需信息，否则不要发送图像。 案例 3：你已从映像 许可和联合权限 页中列出的映像提供商之一获得映像许可：
|
| 映像许可证 ID | Imageld 是用于唯一标识图像的 ID。 Imagelds 由主要图像许可方（如 Getty、Corbis 和美联社）用来跟踪其图像的联合。 |
| 映像许可方名称 | 映像许可方的名称。 (请参阅 映像许可和联合权限 页 - 如果映像不是其中之一，请不要) |
| 说明 | 有关图像内容的文本信息。 此值必须以纯文本形式提供，但在幻灯片放映中使用图像时除外;在这种情况下，允许使用 HTML。 |
| 图像替换文字 | 图像的简短描述性文本替代项。 用于改进辅助功能和支持屏幕阅读器，并且可能会在图像加载失败时显示。 |
| 图像焦点 | 图像的焦点。 在图像裁剪为 “否” 以显示在不同大小的设备上时使用。 |
相关链接
相关链接不是根内容类型，但可以附加到文章或幻灯片放映。 相关链接必须至少具有 有效的 URL、 标题和 缩略图 图像。
必填字段
| 字段名称 | 说明 |
|---|---|
| URL | 相关链接的 URL。 |
| 标题 | 要显示为链接文本的标题。 |
| 缩略图 | 必须在相关链接中提供缩略图 URL，否则将被忽略 |
可选字段，但建议
| 字段名称 | 说明 |
|---|---|
| Relation | 目前，我们仅支持“text/html”作为类型。 |
| 媒体类型 | 在相关链接的压缩设置 URL 中使用的可选标题。 |
| 短标题 | 默认情况下，此值将设置为“相关”。 |
更新以前引入的项
必须通过更改“ 更新日期 ”或“ 发布日期 ”字段，将更新的内容标记为Microsoft引入服务。 将跳过其中一个字段未更改的更新内容。 请记住保留相同的 唯一 ID。
Microsoft引入服务分析源并将其拆分为多个项，决定是发布新项、更新现有项还是跳过它。
更新内联视频
视频可以通过媒体 RSS 或 HTML 内联发布。 视频 URL 是其唯一 ID。 具有相同 URL 的任何 HTML 视频都将标记为重复并跳过，但如果更新，则可以更新 <dcterms:modified> 使用 Media RSS 的视频。 如果未更新此字段，视频将被视为重复。
更新幻灯片放映
通过 Media RSS 发布的幻灯片放映可以设置为 <dcterms:modified> 新的日期，以指示幻灯片放映已更新。
更新映像
图像的源 URL 是其唯一 ID。 具有相同 URL 的图像将被标记为重复项并跳过。
避免重复项
源项由其 唯一 ID 标识。 具有相同唯一 ID 的项目被规则为重复项并跳过，除非它们已通过更改“ 更新日期 ”或“ 发布日期” 字段标记为更新。 不会引入每次轮询源时自动更新唯一 ID、更新日期或发布日期的源。
避免缺陷
格式有缺陷、无效日期或低质量媒体嵌入等缺陷可能会导致用户体验不佳，并可能限制内容访问范围。 在“发布指南”部分的“内容排名”页上详细了解要避免的缺陷。
日期格式
为了确保我们的内容与我们的消费者相关，我们必须确保我们显示的文章是准确的日期。 日期必须使用 RFC 3339 或 RFC 822 日期格式表示。 日期字符串中的任何文本都应采用英语，并且时区应以 UTC 表示，而不是任何本地时区（如东部Standard时间）。
RFC3339
2022-12-28T07：20：50.52Z
2022-12-28T07：20：50.52-07：00
2022-12-28T07：20：50.52+04：00
RFC822
周三， 2002 年 10 月 2 日 13：00：00 GMT
周三， 02 Oct 2002 15：00：00 +0200