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>, <caption>, <colgroup>

Списъци

  • <ul>, <ol>, <li>

Оформление

  • <p>, <div>, <span>, <br>

Вграждане (ограничено)

  • <blockquote>, <iframe> (само за поддържани платформи за видео и социални мрежи – вижте по-долу)

Забранени HTML етикети

Следните етикети ще бъдат премахнати автоматично по време на поглъщането и може да попречат на успешното публикуване:

  • <style>, <script>, <object>, <embed>, <param>, <applet>
  • Всички <мултимедийни> етикети, които не са правилно формирани (например липсват задължителни атрибути)
  • Рекламни обвивка, добавени от услуги на трети лица (например обвивки от Гифи)

Най-добри практики

  • Избягвайте дълбоко вложени структури (запазете 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>

Example of takedown entry


  <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 трябва да съвпадат с това, което бихте показвали във визуализатор на визуално слайдшоу.
  • Не забравяйте да пренасяте всеки RTF текст в <![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> трябва да включва крайна дата в миналото, за да се премахне видимостта на елемента.