Jak przygotować kanał wideo MRSS dla Nonli

Nonli akceptuje kanały Media RSS (MRSS) oparte na RSS 2.0. Ten format pozwala Nonli bezpośrednio importować metadane redakcyjne, plik MP4 i jego miniaturę na potrzeby zautomatyzowanej publikacji wideo.

Gdy ta sama treść jest dostępna w formacie poziomym i pionowym, obie wersje muszą być zgrupowane w tym samym elemencie <item>. Nonli może wtedy wybrać wersję pasującą do docelowego typu posta bez dwukrotnego indeksowania treści redakcyjnej.

Jeśli Nonli pobiera stronę artykułu HTML zamiast kanału, skorzystaj z dokumentacji metatagów HTML Nonli. Opisuje ona obecne pole nli:video oraz planowany kontrakt wersji standard/short.

1. Struktura referencyjna#

1<?xml version="1.0" encoding="UTF-8"?>
2<rss
3  version="2.0"
4  xmlns:dc="http://purl.org/dc/elements/1.1/"
5  xmlns:media="http://search.yahoo.com/mrss/"
6>
7  <channel>
8    <title>Example video feed</title>
9    <link>https://www.example.com/</link>
10    <description>Videos available for Nonli</description>
11    <language>en</language>
12
13    <item>
14      <guid isPermaLink="false">ef88ec32-3810-11f1-88c3-598b8dedbf8b</guid>
15      <pubDate>Tue, 14 Apr 2026 14:53:18 +0000</pubDate>
16      <title>Magyar wins in Hungary</title>
17      <description>Péter Magyar won the election...</description>
18      <link>https://www.example.com/en/video/20260414-magyar-wins</link>
19      <category>Europe</category>
20      <dc:creator>Elisabeth Allain</dc:creator>
21
22      <media:group>
23        <media:content
24          url="https://media.example.com/video-horizontal.mp4"
25          type="video/mp4"
26          medium="video"
27          isDefault="true"
28          width="1920"
29          height="1080"
30          duration="142"
31        >
32          <media:category scheme="urn:nonli:format">video</media:category>
33          <media:title>Magyar wins in Hungary</media:title>
34          <media:thumbnail url="https://media.example.com/thumbnail-16x9.jpg" />
35        </media:content>
36
37        <media:content
38          url="https://media.example.com/video-vertical.mp4"
39          type="video/mp4"
40          medium="video"
41          width="1080"
42          height="1920"
43          duration="58"
44        >
45          <media:category scheme="urn:nonli:format">short</media:category>
46          <media:title>Magyar wins in Hungary (short)</media:title>
47          <media:thumbnail url="https://media.example.com/thumbnail-9x16.jpg" />
48        </media:content>
49      </media:group>
50    </item>
51  </channel>
52</rss>

2. Wymagane pola każdego elementu#

Elementy category i dc:creator są zalecane, aby wzbogacić filtry i treść postów, ale nie są wymagane.

3. Określ formaty wideo#

Wartość media:category decyduje o tym, jak Nonli używa danej wersji:

• video: standardowe wideo, zwykle poziome 16:9;
• short: krótkie wideo pionowe, zwykle 9:16, przeznaczone do formatów Reels, Shorts i ich odpowiedników.

Schemat urn:nonli:format jest wymagany, aby tej klasyfikacji technicznej nie można było pomylić z redakcyjną kategorią MRSS.

Element <item> może zawierać tylko video, tylko short albo oba formaty. Nie może zawierać więcej niż jednej wersji na format. Jeśli dwa pliki przedstawiają różne treści redakcyjne, opublikuj je jako dwa osobne elementy <item> z różnymi identyfikatorami GUID.

Aby oznaczyć preferowaną wersję, dodaj isDefault="true" tylko do jednego elementu media:content w grupie.

4. Dostępność multimediów#

Nonli musi móc pobrać kanał, wideo i miniatury ze swoich serwerów:

• używaj wyłącznie bezwzględnych adresów URL HTTPS;
• zwracaj kod HTTP 200 bez pośredniej strony HTML;
• unikaj plików cookie, sesji, tymczasowych tokenów i przekierowań zależnych od przeglądarki;
• udostępniaj nagłówek Content-Type zgodny z plikiem (application/rss+xml, video/mp4, image/jpeg lub image/png);
• utrzymuj ważność adresów URL multimediów wystarczająco długo, aby umożliwić ponowną próbę importu;
• jeśli kanał używa tokenu w adresie URL, przekaż go Nonli bezpiecznym kanałem komunikacji i uzgodnij rotację tokenu.

Adres URL YouTube ani strona odtwarzania nie zastępują bezpośredniego adresu URL pliku MP4.

Jeśli Twój proces pracy publikuje te wideo na kanałach YouTube należących do Content Ownera, skonfiguruj i sprawdź automatyczne roszczenia i monetyzację osobno.

5. Aktualizacje i wydajność#

• Sortuj wpisy od najnowszego do najstarszego.
• Ogranicz liczbę wpisów, ale tak, aby obejmowały nowe publikacje między dwoma sprawdzeniami kanału.
• Nigdy nie używaj ponownie identyfikatora GUID dla innej treści.
• Zachowaj ten sam identyfikator GUID przy poprawianiu tytułu, opisu, miniatury lub wersji.
• Udostępniaj nagłówki ETag i/lub Last-Modified oraz obsługuj zapytania warunkowe, jeśli Twoja infrastruktura na to pozwala.
• Unikaj powielania tej samej treści w kilku kanałach, gdy jeden kanał na markę i język może zgrupować jej wersje.

6. Lista kontrolna weryfikacji#

Przed udostępnieniem kanału Nonli sprawdź, czy:

• kod XML jest poprawny i deklaruje przestrzenie nazw media i dc;
• każdy element ma stały identyfikator GUID, datę, tytuł i link kanoniczny;
• każdy element media:content wskazuje bezpośrednio na dostępny plik MP4;
• wymiary i czas trwania odpowiadają rzeczywistemu plikowi;
• każda wersja ma dokładnie kategorię video lub short ze schematem urn:nonli:format;
• poziome i pionowe wersje tej samej treści są zgrupowane w tym samym elemencie <media:group>;
• każda wersja ma dostępną miniaturę;
• ponowne pobranie kanału nie zmienia istniejących identyfikatorów GUID.