MSN HTML 准则和标记限制

本页概述了 MSN 合作伙伴中心中提交的源内容的 MSN HTML 格式设置准则和限制。 遵循这些标准，确保成功引入 MSN 并优化显示。

本文内容

允许 HTML 的位置

允许的 HTML 标记

不允许的 HTML 标记

支持的嵌入

媒体 RSS 和源标记示例

ATOM 和 RSS 代码示例

允许 HTML 的位置

允许在以下字段中使用 HTML：

  • 文章正文
  • 幻灯片 放映幻灯片的说明 字段

其他源字段 不支持 HTML，包括标题、作者姓名或类别标签等元数据元素。

允许的 HTML 标记

仅使用以下支持的标记来确保内容正确呈现。

文本格式

  • <b>、 <i>、 <em>、 <strong>、 <sub>、 <sup>、 <small>

标题

  • <h1> 到 <h5>
  • <具有> href 的 (;必须以 https://、http:// 或 mailto：) 开头

图像

  • <img> (必须使用绝对 URL)

表格

  • <table>， <thead>， <tbody>， <tfoot>， <tr>， <td>， th>， <<col>， <描述文字>， <colgroup>

列表

  • <ul>、 <ol>、 <li>

布局

  • <p>， <div>， <span>， <br>

嵌入 (有限)

  • <blockquote>、 <iframe> (仅适用于支持的视频和社交平台 — 请参阅下面的)

不允许的 HTML 标记

以下标记将在引入过程中自动去除，并可能阻止成功发布：

  • <style>， <script>， <object>， <embed>， <param>， <applet>
  • 任何 <格式不正确 (媒体> 标记，例如缺少所需的属性)
  • 第三方服务 (添加的促销包装器，例如 Giphy 包装器)

最佳做法

  • 避免深层嵌套结构， () 将 HTML 层次结构保持在 10 个级别以下。
  • 不要在一行中使用多个 <br> 标记作为间距。
  • 避免包含内联样式或 JavaScript。

支持的嵌入

只能对以下服务使用 <iframe> 或特定于平台的嵌入代码：

  • YouTube

重要

由于 YouTube 方面最近的平台更改，MSN 目前无法审查 YouTube 嵌入。 因此，通过源或文章 HTML 提交的所有 YouTube 3PP 视频将在引入期间被拒绝。 此问题影响全球内容的一小部分，但合作伙伴应避免使用 YouTube 嵌入，直到另行通知。 恢复支持后，我们将更新本指南。

  • X
  • Facebook
  • Instagram
  • Pinterest
  • Spotify
  • Infogram
  • Google Maps
  • Giphy
  • 蓬勃发展
  • Reddit
  • TikTok

所有嵌入都必须使用 https:// URL。 处理期间，将删除不受支持的服务中的嵌入代码。

媒体 RSS 和源标记示例

媒体 RSS 可用于 RSS 和 ATOM 源，以在 MSN 上显示媒体内容（如图像和视频）。

嵌入媒体内容

标记 <media:content> 用于在文章中嵌入图像和视频。 此标记不能与 HTML 元素组合，因此必须在项的根级别指定它。 媒体 RSS 标记必须在 RSS 或 <entry> ATOM 源中指定为 的<item>直接子级，否则将被忽略。

嵌入图像


<media:content 
    url="https://contoso.com/image-source.jpg" 
    type="image/jpeg" 
    medium="image">

  <media:title>Image title</media:title>

  <media:text>Image1 alt-text</media:text>

  <media:credit>Joe Gargery/Fabrikam Images</media:credit>

</media:content>

嵌入式视频


<media:content 
    url="https://contoso.com/video.mp4" 
    duration="91" 
    type="video/mp4" 
    medium="video">

  <media:title>Video title</media:title>

  <media:description>Video abstract/description</media:description>

  <media:credit>Joe Gargery/Fabrikam Videos</media:credit>

</media:content>

嵌入库

库可以使用 标记嵌入到文章 <media:group> 中。 这充当标记为 <media:content>的幻灯片的容器。

嵌入式幻灯片放映


<media:group>

  <media:title>Slideshow title</media:title>

  <media:credit role="author">Slideshow author</media:credit>

  <media:content 
      url="https://contoso.com/image1.jpg" 
      type="image/jpeg" 
      medium="image">

    <media:title>Slide 1 title</media:title>
    <media:text>Slide 1 alt-text</media:text>
    <media:description>Slide 1 description</media:description>

  </media:content>

  <media:content 
      url="https://contoso.com/image2.jpg" 
      type="image/jpeg" 
      medium="image">

    <media:title>Slide 2 title</media:title>
    <media:text>Slide 2 alt-text</media:text>
    <media:description>Slide 2 description</media:description>

  </media:content>

</media:group>

ATOM 和 RSS 代码示例

使用以下代码片段来帮助管理源。 请记住使用 MSN 合作伙伴中心预览内容并发现任何呈现问题。

ATOM 文章源

请注意，ATOM 仅在级别支持文章 <entry> 。 幻灯片放映和视频可以嵌入到文章中。 

源标头 (所需的结构) 


<?xml version="1.0" encoding="utf-8"?>
<!-- The root element must include declaration of used namespaces. -->
<feed xmlns="http://www.w3.org/2005/Atom"
      xmlns:media="http://search.yahoo.com/mrss/"
      xmlns:mi="http://schemas.ingestion.microsoft.com/common/"
      xmlns:dcterms="http://purl.org/dc/terms/"
      xml:lang="en-us">

  <id>https://v3spec.msn.com/myfeed.xml</id>
  <title><![CDATA[Feed title]]></title>
  <subtitle><![CDATA[Feed subtitle]]></subtitle>
  <updated>2017-10-02T13:00:00.52Z</updated>

  <author>
    <name>Feed author</name>
    <email>author@contoso.com</email>
  </author>

基本文章条目


  <entry>
    <!-- REQUIRED: Unique ID for this article -->
    <id>https://v3spec.msn.com/article123.htm</id>

    <!-- REQUIRED: Title -->
    <title><![CDATA[High-definition video encoding and streaming]]></title>

    <!-- REQUIRED: Publish date -->
    <published>2017-01-10T10:00:00+0100</published>

    <!-- Last update date -->
    <updated>2017-10-02T13:00:00.52Z</updated>

    <!-- REQUIRED: Canonical link -->
    <link rel="self" href="https://v3spec.msn.com/article123.htm" />

    <!-- Author information -->
    <author>
      <name><![CDATA[Joe Gargery]]></name>
    </author>

    <!-- Optional subtitle -->
    <dcterms:alternative>Article subtitle</dcterms:alternative>

过期选项


    <!-- Option 1: Using dcterms:valid -->
    <dcterms:valid>
      start=2016-10-01T10:00:00+0100; 
      end=2018-10-02T10:00:00+0100; 
      scheme=W3C-DTF
    </dcterms:valid>

    <!-- Option 2: Using mi:expirationDate -->
    <mi:expirationDate>2018-10-02T13:00:00.52Z</mi:expirationDate>

分类和元数据


    <!-- Short title (<= 40 chars) -->
    <mi:shortTitle><![CDATA[Short Title]]></mi:shortTitle>

    <!-- Keywords -->
    <media:keywords>keyword1,keyword2,keyword3</media:keywords>

    <!-- Categories -->
    <category term="News" />
    <category term="Sports" />​​​​​​​

摘要和正文内容
 


    <!-- Plain text abstract -->
    <summary><![CDATA[ Article abstract/description should be plain text, no HTML is allowed ]]></summary>

    <!-- HTML-formatted body (use CDATA to avoid escaping HTML) -->
    <content type="html">
      <![CDATA[
        <p>Media Services enables you to encode your media files...</p>
        <img src="https://v3spec.msn.com/_files/assets/azure1.jpg"
             alt="Image title"
             title="Image title"
             data-portal-copyright="Joe Gargery/Fabrikam Images"
             data-has-syndication-rights="1"
             data-license-id="698526"
             data-licensor-name="Licensor name"
             data-focal-region="x1:246,y1:140,x2:246,y2:140" />
      ]]>
    </content>

内联媒体示例

内联视频 (1PP) 


​​​​​​​    <video id="8172818"
           title="an inline video"
           poster="https://contoso.com/videothumbnail.jpg"
           data-description="this is a sample inline video">
      <source src="https://contoso.com/video.mp4" type="video/mp4"/>
    </video>

内联视频 (3PP YouTube) 


    <iframe width="100%" height="100%"
            frameborder="0"
            allowfullscreen="true"
            src="https://www.youtube.com/embed/XnZ_J3l_0z4?rel=0">
    </iframe>



Inline slideshow


    <div class="slideshow">
      <cite>Slideshow author</cite>
      <title>Slideshow title</title>
      <figure>
        <img src="https://v3spec.msn.com/image1.jpg" title="slide 1 title"/>
        <figcaption>slide 1 caption <span class="copyright">slide 1 copyrights</span></figcaption>
      </figure>
      <figure>
        <img src="https://v3spec.msn.com/image2.jpg" title="slide 2 title"/>
        <figcaption>slide 2 caption <span class="copyright">Joe Gargery/Fabrikam Images</span></figcaption>
      </figure>
    </div>



Media:Content examples


    <!-- Image -->
    <media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
      <media:credit>Joe Gargery/Fabrikam Images</media:credit>
      <media:title>Image title</media:title>
      <media:text>Image alt-text</media:text>
      <mi:focalRegion>
        <mi:x1>120</mi:x1><mi:y1>120</mi:y1>
        <mi:x2>400</mi:x2><mi:y2>400</mi:y2>
      </mi:focalRegion>
      <mi:hasSyndicationRights>1</mi:hasSyndicationRights>
      <mi:licenseId>698525</mi:licenseId>
      <mi:licensorName>Licensor name</mi:licensorName>
    </media:content>

    <!-- Video -->
    <media:content url="https://v3spec.msn.com/video.mp4" duration="91" type="video/mp4" medium="video">
      <guid>218736</guid>
      <media:thumbnail url="https://v3spec.msn.com/image.jpg"/>
      <media:title>Video title</media:title>
      <media:description>Video description</media:description>
      <media:credit>Joe Gargery/Fabrikam Videos</media:credit>
    </media:content>



Related links example


    <link rel="related" type="text/html"
          href="https://v3spec.msn.com/news/prop_irs_1.html"
          title="New IRS proposal">
      <media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail1.jpg"/>
    </link>

下架条目示例


  <entry>
    <!-- REQUIRED: Unique identifier of content to remove -->
    <id>https://v3spec.msn.com/article123.htm</id>
    <updated>2017-10-02T13:00:00.52Z</updated>

    <!-- Expiration in the past = takedown -->
    <dcterms:valid>
      start=2019-10-01T10:00:00+0100; 
      end=2018-10-02T10:00:00+0100; 
      scheme=W3C-DTF
    </dcterms:valid>
  </entry>
</feed>

RSS 文章源


​​​​​​​<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom"
     xmlns:media="http://search.yahoo.com/mrss/"
     xmlns:mi="http://schemas.ingestion.microsoft.com/common/"
     xmlns:dc="http://purl.org/dc/elements/1.1/"
     xmlns:content="http://purl.org/rss/1.0/modules/content/"
     xmlns:dcterms="http://purl.org/dc/terms/"
     version="2.0">
 



 <channel>
    <!-- Channel metadata -->
    <title>Lifestyle</title> <!-- REQUIRED -->
    <description>Channel description</description> <!-- REQUIRED -->
    <language>en-us</language> <!-- REQUIRED -->
    <link>https://v3spec.msn.com/lifestyle</link> <!-- REQUIRED -->

    <!-- Begin article item -->
    <item>

      <!-- REQUIRED: Unique article identifier -->
      <guid isPermaLink="false">477648</guid>

      <!-- REQUIRED: Headline/title of the article -->
      <title><![CDATA[High-definition video encoding and streaming]]></title>

      <!-- REQUIRED: Publication date -->
      <pubDate>2017-10-04T08:00:00-05:00</pubDate>

      <!-- OPTIONAL: Last modified date -->
      <dcterms:modified>2017-10-10T10:00:00+0100</dcterms:modified>

      <!-- REQUIRED: URL to full article -->
      <link>https://v3spec.msn.com/articleid=2836489202/</link>

      <!-- OPTIONAL: Author name -->
      <dc:creator>Joe Gargery</dc:creator>

      <!-- OPTIONAL: Subtitle -->
      <dcterms:alternative>Article subtitle</dcterms:alternative>

      <!-- OPTIONAL: Article validity window -->
      <dcterms:valid>start=2016-10-01T10:00:00+0100; end=2018-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>

      <!-- OPTIONAL: Expiration date -->
      <mi:expirationDate>2018-10-02T13:00:00.52Z</mi:expirationDate>

      <!-- OPTIONAL: Short title for UI (<= 40 characters) -->
      <mi:shortTitle>Short Title</mi:shortTitle>

      <!-- OPTIONAL: Comma-separated keywords -->
      <media:keywords>keyword1,keyword2,keyword3</media:keywords>

      <!-- OPTIONAL: Categories -->
      <category>News</category>
      <category>Sports</category>

      <!-- OPTIONAL: Summary (no HTML allowed) -->
      <description><![CDATA[ Article description should be plain text, no HTML is allowed ]]></description>

      <!-- REQUIRED: Full HTML article content -->
      <content:encoded><![CDATA[
        <img src="https://v3spec.msn.com/_files/assets/azure1.jpg" alt="Image title here." />
        <p>Media Services enables you to encode your media files...</p>
        <p>Here is an example of an embedded 1PP video:</p>
        <video id="8172818" poster="https://v3spec.msn.com/videothumbnail.jpg">
          <source src="https://v3spec.msn.com/video.mp4" type="video/mp4" />
        </video>
        <p>Example of embedded YouTube video:</p>
        <iframe src="https://www.youtube.com/embed/XnZ_J3l_0z4?rel=0"></iframe>
        <p>Example of inline slideshow:</p>
        <div class="slideshow">
          <figure>
            <img src="https://v3spec.msn.com/image1.jpg" />
            <figcaption>slide 1 caption</figcaption>
          </figure>
        </div>
      ]]></content:encoded>

      <!-- REQUIRED: Main article image -->
      <media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
        <!-- OPTIONAL: Image credit -->
        <media:credit>Joe Gargery/Fabrikam Images</media:credit>
        <!-- OPTIONAL: Image title -->
        <media:title>Image title</media:title>
        <!-- OPTIONAL: Image alt text -->
        <media:text>Image alt-text</media:text>
        <!-- OPTIONAL: Focal crop region -->
        <mi:focalRegion>
          <mi:x1>120</mi:x1><mi:y1>120</mi:y1><mi:x2>400</mi:x2><mi:y2>400</mi:y2>
        </mi:focalRegion>
        <!-- OPTIONAL: Licensing metadata -->
        <mi:hasSyndicationRights>1</mi:hasSyndicationRights>
        <mi:licenseId>698525</mi:licenseId>
        <mi:licensorName>Licensor name</mi:licensorName>
      </media:content>

      <!-- OPTIONAL: 3rd party video metadata -->
      <media:content url="https://v3spec.msn.com/video.mp4" duration="91" type="video/mp4" medium="video">
        <!-- REQUIRED inside video metadata -->
        <guid>218736</guid>
        <media:thumbnail url="https://v3spec.msn.com/image.jpg" />
        <media:title>Video title</media:title>
        <media:description>Video description</media:description>
        <media:credit>Joe Gargery/Fabrikam Videos</media:credit>
        <media:subTitle type="application/ttml" lang="en" href="https://www.contols.org/closedcaptions.ttml" />
      </media:content>

      <!-- OPTIONAL: Inline slideshow -->
      <media:group>
        <media:title>Slideshow title</media:title>
        <media:credit role="author">Slideshow author</media:credit>
        <media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
          <media:credit>Joe Gargery/Fabrikam Images</media:credit>
          <media:title>Slide 1 title</media:title>
          <media:text>Slide 1 alt-text</media:text>
          <media:description><![CDATA[<p>Slide 1 description</p>]]></media:description>
        </media:content>
        <media:content url="https://v3spec.msn.com/image2.jpg" type="image/jpeg" medium="image">
          <media:credit>Joe Gargery/Fabrikam Images</media:credit>
          <media:title>Slide 2 title</media:title>
          <media:text>Slide 2 alt-text</media:text>
          <media:description>Slide 2 description</media:description>
        </media:content>
      </media:group>

      <!-- OPTIONAL: Related links with thumbnails -->
      <atom:link rel="related" type="text/html" href="https://v3spec.msn.com/news/prop_irs_1.html" title="New IRS proposal">
        <media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail1.jpg" />
      </atom:link>
      <atom:link rel="related" type="text/html" href="https://v3spec.msn.com/news/prop_irs_2.html" title="New IRS proposal">
        <media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail2.jpg" />
      </atom:link>

    </item>
  </channel>
</rss>

RSS 幻灯片放映源


<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:atom="http://www.w3.org/2005/Atom"
     xmlns:media="http://search.yahoo.com/mrss/"
     xmlns:mi="http://schemas.ingestion.microsoft.com/common/"
     xmlns:dc="http://purl.org/dc/elements/1.1/"
     xmlns:content="http://purl.org/rss/1.0/modules/content/"
     xmlns:dcterms="http://purl.org/dc/terms/"
     version="2.0">

  <channel>
    <title>Lifestyle</title>
    <description>channel description</description>
    <language>en-us</language>
    <link>https://v3spec.msn.com/lifestyle</link>

    <!-- BEGIN ARTICLE ITEM -->
    <item>

      <!-- Required Metadata -->
      <guid isPermaLink="false">477648</guid>
      <title><![CDATA[High-definition video encoding and streaming]]></title>
      <pubDate>2017-10-04T08:00:00-05:00</pubDate>
      <dcterms:modified>2017-10-10T10:00:00+0100</dcterms:modified>
      <link>https://v3spec.msn.com/articleid=2836489202/</link>

      <!-- Author and Metadata -->
      <dc:creator>Joe Gargery</dc:creator>
      <dcterms:alternative>Article subtitle</dcterms:alternative>
      <dcterms:valid>start=2016-10-01T10:00:00+0100; end=2018-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>
      <mi:expirationDate>2018-10-02T13:00:00.52Z</mi:expirationDate>
      <mi:shortTitle>Short Title</mi:shortTitle>
      <media:keywords>keyword1,keyword2,keyword3</media:keywords>

      <!-- Categories and Summary -->
      <category>News</category>
      <category>Sports</category>
      <description><![CDATA[ Article description should be plain text, no HTML is allowed ]]></description>

      <!-- Article Body (HTML) -->
      <content:encoded><![CDATA[
        <img src="https://v3spec.msn.com/_files/assets/azure1.jpg"
             alt="Image title here."
             title="Image title"
             data-portal-copyright="Joe Gargery/Fabrikam Images"
             data-has-syndication-rights="1"
             data-license-id="698526"
             data-licensor-name="Licensor name"
             data-focal-region="x1:246,y1:140,x2:246,y2:140" />

        <p>Media Services enables you to encode your media files...</p>

        <p>Here is an example of an embedded 1PP video:</p>
        <video id="8172818"
               title="an inline video"
               poster="https://v3spec.msn.com/videothumbnail.jpg"
               data-description="this is a sample inline video"
               data-portal-copyright="Joe Gargery/Fabrikam Videos">
          <source src="https://v3spec.msn.com/video.mp4" type="video/mp4" />
        </video>

        <p>Example of embedded YouTube video:</p>
        <iframe src="https://www.youtube.com/embed/XnZ_J3l_0z4?rel=0" frameborder="0" allowfullscreen></iframe>

        <p>Example of inline slideshow:</p>
        <div class="slideshow">
          <cite>Slideshow author</cite>
          <title>Slideshow title</title>
          <figure>
            <img src="https://v3spec.msn.com/image1.jpg" title="slide 1 title" />
            <figcaption>slide 1 caption <span class="copyright">slide 1 copyrights</span></figcaption>
          </figure>
          <figure>
            <img src="https://v3spec.msn.com/image2.jpg" title="slide 2 title" />
            <figcaption>slide 2 caption <span class="copyright">Joe Gargery/Fabrikam Images</span></figcaption>
          </figure>
        </div>
      ]]></content:encoded>

      <!-- Featured Image Metadata -->
      <media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
        <media:credit>Joe Gargery/Fabrikam Images</media:credit>
        <media:title>Image title</media:title>
        <media:text>Image alt-text</media:text>
        <mi:focalRegion>
          <mi:x1>120</mi:x1><mi:y1>120</mi:y1><mi:x2>400</mi:x2><mi:y2>400</mi:y2>
        </mi:focalRegion>
        <mi:hasSyndicationRights>1</mi:hasSyndicationRights>
        <mi:licenseId>698525</mi:licenseId>
        <mi:licensorName>Licensor name</mi:licensorName>
      </media:content>

      <!-- Video Metadata (3PP) -->
      <media:content url="https://v3spec.msn.com/video.mp4" duration="91" type="video/mp4" medium="video">
        <guid>218736</guid>
        <media:thumbnail url="https://v3spec.msn.com/image.jpg" />
        <media:title>Video title</media:title>
        <media:description>Video description</media:description>
        <media:credit>Joe Gargery/Fabrikam Videos</media:credit>
        <media:subTitle type="application/ttml" lang="en" href="https://www.contols.org/closedcaptions.ttml" />
      </media:content>

      <!-- Inline Slideshow -->
      <media:group>
        <media:title>Slideshow title</media:title>
        <media:credit role="author">Slideshow author</media:credit>

        <media:content url="https://v3spec.msn.com/image1.jpg" type="image/jpeg" medium="image">
          <media:credit>Joe Gargery/Fabrikam Images</media:credit>
          <media:title>Slide 1 title</media:title>
          <media:text>Slide 1 alt-text</media:text>
          <media:description><![CDATA[<p>Slide 1 description</p>]]></media:description>
        </media:content>

        <media:content url="https://v3spec.msn.com/image2.jpg" type="image/jpeg" medium="image">
          <media:credit>Joe Gargery/Fabrikam Images</media:credit>
          <media:title>Slide 2 title</media:title>
          <media:text>Slide 2 alt-text</media:text>
          <media:description>Slide 2 description</media:description>
        </media:content>
      </media:group>

      <!-- Related Links -->
      <atom:link rel="related" type="text/html" href="https://v3spec.msn.com/news/prop_irs_1.html" title="New IRS proposal">
        <media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail1.jpg" />
      </atom:link>

      <atom:link rel="related" type="text/html" href="https://v3spec.msn.com/news/prop_irs_2.html" title="New IRS proposal">
        <media:thumbnail url="https://v3spec.msn.com/related_link_thumbnail2.jpg" />
      </atom:link>

    </item>
    <!-- END ARTICLE ITEM -->

  </channel>
</rss>

注意

  • 用于 media:content 每个幻灯片图像。
  • 始终为每个项包括 guid、 title和 pubDate 。
  • media:title和 media:description 应与要在可视化幻灯片放映查看器中显示的内容匹配。
  • 请务必在 中 <![CDATA[]]>包装任何富文本。
  • 将 atom:link 与 media:thumbnail 用于相关文章链接。

RSS 音频源

RSS 音频源示例


<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
     xmlns:media="https://search.yahoo.com/mrss/"
     xmlns:mi="https://schemas.ingestion.microsoft.com/common/"
     xmlns:dc="https://purl.org/dc/elements/1.1/"
     xmlns:content="https://purl.org/rss/1.0/modules/content/"
     xmlns:dcterms="https://purl.org/dc/terms/"
     xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
  <channel>

    <!-- Channel Metadata -->
    <title>Feed title</title>
    <link>https://www.contoso.com/sports</link>
    <description>Feed description</description>
    <lastBuildDate>01 Oct 2017 13:00:00 GMT</lastBuildDate>

    <!-- Example 1: Audio using Media RSS -->
    <item>
      <guid isPermaLink="false">723435</guid>
      <title>Example audio using Media RSS</title>
      <pubDate>01 Oct 2018 13:00:00 GMT</pubDate>
      <dcterms:modified>2018-10-10T10:00:00+0100</dcterms:modified>
      <link>https://v3spec.msn.com/audioid=2836489202/</link>
      <dcterms:valid>start=2016-10-01T10:00:00+0100; end=2018-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>
      <description>Audio description</description>

      <media:content url="https://contoso.com/audio/sample.mp3"
                     duration="512"
                     type="audio/mpeg"
                     medium="audio">
        <media:thumbnail url="https://v3spec.msn.com/image.jpg"
                         height="480"
                         width="853" />
        <media:title>Example audio using Media RSS</media:title>
        <media:description>Audio description</media:description>
        <media:credit>Joe Gargery/Fabrikam Videos</media:credit>
      </media:content>
    </item>

    <!-- Example 2: Audio using iTunes Namespace -->
    <item>
      <guid isPermaLink="false">723435</guid>
      <title>Example audio using iTunes namespace</title>
      <pubDate>01 Oct 2018 13:00:00 GMT</pubDate>
      <link>https://v3spec.msn.com/audioid=2836489202/</link>
      <dcterms:modified>2018-10-10T10:00:00+0100</dcterms:modified>
      <dcterms:valid>start=2016-10-01T10:00:00+0100; end=2018-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>
      <description>Audio description</description>

      <itunes:title>Audio stream title</itunes:title>
      <itunes:author>Provider name</itunes:author>
      <itunes:subtitle>Audio stream subtitle</itunes:subtitle>
      <itunes:summary><![CDATA[audio stream description]]></itunes:summary>
      <itunes:duration>110</itunes:duration>

      <enclosure url="https://contoso.com/audio/sample.mp3"
                 type="audio/mpeg" />
    </item>

  </channel>
</rss>

关键说明

部分 说明
<media:content> 用于媒体 RSS 格式。 支持缩略图、信用额度和元数据。
<itunes:*> 用于播客样式的源。 包括作者、摘要和持续时间。
<enclosure> iTunes 源是必需的。 指向实际的 MP3 流。
guid 每个项目必须唯一;不要重复使用。
pubDate 必需。 使用 RFC 822 或 RFC 3339 格式。
dcterms:valid 控制自定义过期 (可选) 。

RSS 视频源

RSS 视频源示例


<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
     xmlns:atom="http://www.w3.org/2005/Atom"
     xmlns:media="http://search.yahoo.com/mrss/"
     xmlns:mi="http://schemas.ingestion.microsoft.com/common/"
     xmlns:dc="http://purl.org/dc/elements/1.1/"
     xmlns:dcterms="http://purl.org/dc/terms/">

  <channel>

    <!-- Channel Metadata -->
    <title>Feed title</title>
    <link>https://www.contoso.com/sports</link>
    <description>Feed description</description>
    <lastBuildDate>01 Oct 2017 13:00:00 GMT</lastBuildDate>

    <!-- Video Item -->
    <item>

      <!-- Required Metadata -->
      <guid isPermaLink="false">723435</guid>
      <title>Video title</title>
      <pubDate>01 Oct 2017 13:00:00 GMT</pubDate>
      <dcterms:modified>2017-10-10T10:00:00+0100</dcterms:modified>
      <link>https://v3spec.msn.com/articleid=2836489202/</link>

      <!-- Author & Subtitle -->
      <dc:creator>Video author</dc:creator>
      <dcterms:alternative>Article subtitle</dcterms:alternative>

      <!-- Expiration Controls -->
      <dcterms:valid>
        start=2016-10-01T10:00:00+0100; 
        end=2018-10-02T10:00:00+0100; 
        scheme=W3C-DTF
      </dcterms:valid>
      <mi:expirationDate>2018-10-02T13:00:00.52Z</mi:expirationDate>

      <!-- Description & Metadata -->
      <description>Video description</description>
      <media:keywords>keyword1,keyword2,keyword3</media:keywords>
      <category>News</category>
      <category>Sports</category>

      <!-- Video Metadata -->
      <media:content
          url="https://v3spec.msn.com/video.mp4"
          duration="512"
          type="video/mp4"
          medium="video">

        <!-- Thumbnail -->
        <media:thumbnail 
            url="https://v3spec.msn.com/image.jpg"
            height="480"
            width="853" />

        <!-- Title & Description (Overrides) -->
        <media:title>Video title</media:title>
        <media:description>Video description</media:description>

        <!-- Attribution -->
        <media:credit>Joe Gargery/Fabrikam Videos</media:credit>

        <!-- Captions (TTML format) -->
        <media:subTitle 
            type="application/ttml"
            lang="en"
            href="https://www.contols.org/closedcaptions.ttml" />

      </media:content>

    </item>

  </channel>
</rss>

关键说明

部分 用途
<guid> 唯一标识视频项。
<media:content> 嵌入有关实际视频文件的元数据， (URL、类型、持续时间等 )
<media:subTitle> 指向隐藏式字幕的可选 TTML 文件。
<media:title/description> 指定时重写项目级标题/说明。
<mi:expirationDate> 默认 1 年项目生命周期的可选替代。
dcterms:valid 还支持有时间限制的可用性窗口。

下架请求

(RSS 项格式) 的移除请求示例 


<!-- Example of a takedown request.
     You must provide a <guid> of an existing item,
     a modified date, and an expiration date in the past. -->

<item>

  <!-- REQUIRED: Unique identifier of the content to be removed.
       This ID must reference an already ingested document. -->
  <guid isPermaLink="false">477649</guid>

  <!-- REQUIRED: Use <dcterms:modified> to signal that this is a new update. -->
  <dcterms:modified>2017-10-10T10:00:00+0100</dcterms:modified>

  <!-- REQUIRED: Use <dcterms:valid> to specify an end date in the past.
       This will trigger the takedown of the associated content. -->
  <dcterms:valid>end=1990-10-02T10:00:00+0100; scheme=W3C-DTF</dcterms:valid>

</item>

注意

  • 必须与 <guid> 引入历史记录中已存在的项匹配。
  • 需要 <dcterms:modified> 元素才能将此注册为更新。
  • 元素 <dcterms:valid> 必须包含过去的结束日期才能从可见性中删除项。