Рекомендации ПО ДЛЯ HTML и ограничения тегов в MSN

На этой странице описаны рекомендации по форматированию HTML-кода MSN и ограничения для содержимого веб-канала, отправленного в Центре партнеров MSN. Следуйте этим стандартам, чтобы обеспечить успешный прием и оптимальное отображение в MSN.

В этой статье

Где разрешен HTML

Разрешенные теги HTML

Запрещенные HTML-теги

Поддерживаемые внедрения

Примеры разметки RSS и веб-канала мультимедиа

Примеры кода ATOM и RSS

Где разрешен HTML

HTML разрешен в следующих полях:

  • Текст статей
  • Поле описания слайд-шоу

HTML не поддерживается в других полях веб-канала, включая элементы метаданных, такие как заголовки, имена авторов или метки категорий.

Разрешенные теги HTML

Используйте только поддерживаемые теги ниже, чтобы обеспечить правильную отрисовку содержимого.

Форматирование текста

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

Заголовки

  • <h1> – <h5>
  • <a> (с 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. В результате все видео YouTube 3PP, отправленные через веб-каналы или HTML статьи, будут отклонены во время приема. Эта проблема затрагивает небольшую часть глобального содержимого, но партнерам следует избегать использования внедрения YouTube до дальнейшего уведомления. Мы обновим это руководство после восстановления поддержки.

  • X
  • Facebook
  • Instagram
  • Pinterest
  • Spotify
  • Infogram;
  • Google Карты;
  • Giphy
  • Процветать
  • Reddit
  • TikTok

Все внедрения должны использовать HTTPS:// URL-адреса. Код внедрения из неподдерживаемых служб будет удален во время обработки.

Примеры разметки RSS и веб-канала мультимедиа

RsS-каналы мультимедиа можно использовать как в RSS, так и в каналах ATOM для отображения содержимого мультимедиа, например изображений и видео, в MSN.

Внедрение мультимедийного содержимого

Тег <media:content> используется для внедрения изображений и видео в статьи. Этот тег не может сочетаться с элементами HTML, поэтому его необходимо указать на корневом уровне элемента. Теги RSS мультимедиа должны быть указаны как непосредственные дочерние <item> в RSS или <entry> в каналах ATOM, в противном случае они будут игнорироваться.

Внедренное изображение


<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>

Пример записи takedown


  <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:titlemedia: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> Используйте для формата MEDIA RSS. Поддерживает эскизы, кредиты и метаданные.
<itunes:*> Используйте для веб-каналов в стиле podcast. Включает автора, сводку и длительность.
<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 Также поддерживает окна доступности с привязкой к времени.

Запрос на очистку

Пример запроса Takedown (формат элемента 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> должен содержать дату окончания в прошлом, чтобы удалить элемент из видимости.