Podcast-syötteen rakenne ja RSS 2.0 -vaatimukset
Podcast RSS Validator on työkalu, joka tarkistaa sille toimitetun podcast-syötteen yleisten ongelmien varalta. Työkalu analysoi syötteen XML-rakenteen, kanavan ja yksittäisten jaksojen pakolliset kentät, ääni-elementtien tiedot sekä päivämäärien muotoilut. Jotta syöte voidaan tarkistaa, käyttäjän on syötettävä työkaluun täydellinen RSS-syöte, joka sisältää XML-ilmoituksen ja juuren. Työkalun käsittelyrajoitus on enintään 500 000 merkkiä tarkistusta kohden.
Syötteen rakenteen on noudatettava tarkkoja sääntöjä, jotta se tunnistetaan oikein:
- Dokumentin juuren täytyy olla
<rss>. <rss>-elementinversion-attribuutin arvon täytyy olla "2.0".- Apple Podcasts -nimiavaruuden on oltava ilmoitettuna
<rss>-elementissä. - RSS-syötteen täytyy sisältää täsmälleen yksi suora
<channel>-elementti. - Syötteessä ei saa olla DOCTYPE-ilmoitusta. Jos sellainen löytyy, työkalu antaa virheen "Poista DOCTYPE-ilmoitus ennen kuin tarkistat tämän syötteen.".
Jos syötteen XML-rakenne on viallinen tai sitä ei voida tulkita, työkalu ilmoittaa virheestä "Korjaa virheellinen XML ja validoi uudelleen.". Mikäli tarkistus kestää liian kauan, näytetään ilmoitus "Tarkistus kesti liian kauan. Kokeile pienempää syötettä.". Jos taas tarkistusta ei voida suorittaa loppuun, ruudulle tulee ilmoitus "Tarkistusta ei voitu suorittaa loppuun.". Jos käyttäjä yrittää ajaa tarkistuksen tyhjällä syötteellä, työkalu huomauttaa: "Liitä Podcast RSS XML ennen validointia.".
Kanavan ja jaksojen pakolliset kentät
Validoija käy läpi syötteen ja varmistaa, että kaikki vaaditut RSS-kentät sekä yleiset Apple Podcasts -kanava- ja jaksokentät ovat paikoillaan. Jos jokin pakollinen kenttä puuttuu, työkalu antaa virheilmoituksen "Lisää pakollinen kenttä ‹field›.".
Kanavan ja jaksojen kentille on asetettu seuraavat säännöt ja tarkistukset:
- URL-osoitteet: Virheelliset linkit aiheuttavat virheen "
‹field›täytyy olla täydellinen HTTP- tai HTTPS-URL.". - Kuvitukset: Jos kuvan href-attribuutti on virheellinen, työkalu antaa virheen "Aseta itunes:image href täydelliseksi HTTP- tai HTTPS-URL-osoitteeksi.".
- Kategoriat: Jos kategoria on virheellinen, annetaan virheilmoitus "Lisää itunes:category-elementtiin text-attribuutti, joka ei ole tyhjä.".
- Sisällön ikäraja:
<itunes:explicit>-tagin arvoksi on asetettava joko "true" tai "false". - Jaksomäärä: Kanavan täytyy sisältää vähintään yksi jakso. Jos jaksoja ei ole, työkalu antaa virheen "Lisää vähintään yksi <item> jakso kanavalle.".
- Sarjamuotoiset podcastit: Jatkuvissa sarjoissa (serial) jokaisen jakson
<itunes:episode>-arvon täytyy olla positiivinen kokonaisluku. - Yksilölliset tunnisteet: Jokaisella jaksolla on oltava uniikki GUID-tunniste. Jos syötteestä löytyy duplikaatteja, työkalu antaa virheen "Tämä GUID toistaa arvon rivillä
‹first›.".
Äänitiedostojen ja enclosure-elementtien tarkistus
Jokaisella podcast-jaksolla on oltava täsmälleen yksi <enclosure>-elementti, joka linkittää jakson mediatiedostoon. Jos jaksossa on useampia enclosure-elementtejä, työkalu antaa virheen "Jätä tähän jaksoon täsmälleen yksi <enclosure>; löytyi ‹count›.".
Työkalu tekee useita staattisia tarkistuksia enclosure-elementin attribuuteille:
- Puuttuvat attribuutit: Jos jokin vaadittu attribuutti puuttuu, näytetään virhe "Lisää vaadittu
‹attribute›attribuutti <enclosure>.". - URL-osoite: Äänitiedoston osoitteen on oltava oikeassa muodossa. Virheellinen osoite tuottaa virheen "Aseta <enclosure>-elementin url-attribuutiksi täydellinen HTTP- tai HTTPS-URL.". Jos sama enclosure-URL esiintyy syötteessä useasti, työkalu antaa virheen "Tämä liitteen URL toistaa arvon rivillä
‹first›.". - Tiedostokoko (length): Tiedoston pituuden on oltava kokonaisluku. Jos näin ei ole, näytetään virhe "Anna <enclosure>-elementin length-attribuutissa tavujen määrä kokonaislukuna.". Jos pituudeksi on merkitty 0, työkalu antaa varoituksen "<enclosure>-elementin length-attribuutti on 0. Varmista todellinen tavumäärä ennen julkaisua.".
- MIME-tyyppi: Työkalu vaatii pätevän MIME-tyypin (kuten audio/mpeg). Virheellisestä tyypistä seuraa virhe "Käytä pätevää MIME-tyyppiä, kuten audio/mpeg.". Jos MIME-tyyppi ei viittaa äänitiedostoon, annetaan varoitus "Tätä <enclosure>-elementtiä ei ole merkitty ääneksi. Varmista, että video- tai dokumenttijakso on tarkoituksellinen.".
- Tiedostopääte: Jos tiedostonimen pääte ja ilmoitettu MIME-tyyppi eivät täsmää, työkalu antaa varoituksen "Median tiedostonimi ja MIME-tyyppi ovat eri mieltä (
‹extension›vs‹mime›).".
Työkalu tekee ainoastaan staattisia tarkistuksia syötteessä oleville tiedoille; se ei lataa tai pura itse äänitiedostoa.
Päivämäärien muotoilu ja RFC 2822 -standardi
Oikeat julkaisupäivämäärät ovat välttämättömiä, jotta podcast-sovellukset voivat järjestää ja näyttää jaksot oikeassa järjestyksessä. Jos jakson julkaisupäivä puuttuu kokonaan, työkalu antaa varoituksen "Lisää <pubDate>, jotta podcast-sovellukset voivat järjestää ja julkaista tämän jakson luotettavasti.".
Päivämäärien muotoilussa on noudatettava RFC 2822 -standardia. Päivämäärän on sisällettävä todellinen kalenteripäivä sekä aikavyöhyke. Jos päivämäärän muotoilu on virheellinen, työkalu antaa virheilmoituksen: "Käytä RFC 2822 -päivämäärää todellisella kalenteripäivällä ja aikavyöhykkeellä, esimerkiksi: Sat, 01 Apr 2023 19:00:00 +0000.".
Aikavyöhykkeiden ilmoittamisessa suositellaan numeerisia siirtymiä. Jos syötteessä käytetään nimettyä aikavyöhykettä, työkalu antaa varoituksen "Tämä nimetty aikavyöhyke hyväksytään, mutta se on vähemmän siirrettävä; mieluummin käytä numeerista siirtymää, kuten +0000.".
Virheiden tulkinta ja korjaaminen
Kun syöte on validoitu, työkalu näyttää tulokset otsikon "Syötteen tarkistustulos" alla. Jos syötteestä ei löydy virheitä tai varoituksia, näytetään ilmoitus "Rakenteellisia ongelmia ei löytynyt.". Jos ongelmia löytyy, työkalu näyttää yhteenvedon muodossa "‹errors› virheitä ja ‹warnings› varoituksia löytyi.".
Tuloksissa eritellään seuraavat tiedot:
- Löydettyjen virheiden määrä muodossa "Virheitä:
‹count›". - Löydettyjen varoitusten määrä muodossa "Varoituksia:
‹count›". - Syötteestä tunnistettujen jaksojen kokonaismäärä muodossa "Jaksoja:
‹count›".
Jokaisen havaitun ongelman kohdalla ilmoitetaan sen tarkka sijainti muodossa "Rivi ‹line›, sarake ‹column›". Työkalu tarjoaa myös XPath-tyylisen polun ongelmalliseen elementtiin muodossa "Korjaus: ‹path›" sekä suoran linkin kyseiseen kohtaan muodossa "Siirry kohtaan ‹path› rivillä ‹line›". Jos XML-parseri antaa lisätietoja virheestä, ne näytetään muodossa "Parserin yksityiskohta: ‹detail›".
Jos syötteessä on erittäin paljon ongelmia, listaa voidaan lyhentää, jolloin työkalu ilmoittaa: "Näytetään ensimmäiset ‹shown› yhteensä ‹total› ongelmasta.". Lisäksi on hyvä huomioida, että jos syötteessä on yli 2 000 jaksoa, työkalu antaa varoituksen "Tässä syötteessä on ‹count› jaksoa; Apple Podcasts näyttää vain uusimmat 2 000.".
On tärkeää ymmärtää, että staattisen syötteen läpäisy validoinnissa tarkoittaa ainoastaan sitä, että syöte täytti työkalun tekemät staattiset tarkistukset. Se ei takaa, että jokin tietty podcast-hakemisto hyväksyy tai julkaisee syötteen.
Tietosuoja ja käsittely
Podcast RSS Validator on suunniteltu tietoturvalliseksi ja yksityisyyttä kunnioittavaksi. Podcast-syötteesi tarkistetaan suoraan selaimessasi. BroBroGo ei lataa tai tallenna mitään syöttämiäsi tietoja tai XML-sisältöjä.
Usein kysytyt kysymykset (FAQ)
Mitä tämä Podcast RSS Validator tarkistaa?
Se tarkistaa, onko RSS 2.0 XML oikein muodostettu, löytyvätkö pakolliset RSS-kentät sekä tavalliset Apple Podcasts -kanava- ja jaksokentät, ja lisäksi <enclosure>-attribuutit, kaksoiskappaleet ja RFC 2822 -päivämäärät.
Testaako se äänitiedoston?
Se tarkistaa <enclosure>-elementin URL-osoitteen ja tavupituuden, MIME-tyypin, kaksoiskappaleet sekä tiedostonimen ja tyypin vastaavuuden. Ääntä ei ladata eikä pureta.
Hyväksytäänkö syöte, joka menee läpi, kaikkialla?
Ei. Podcast-sovellukset voivat lisätä sääntöjä ja etätarkistuksia. Läpäisee tarkoittaa, että liitetty XML täytti tässä esitetyt staattiset tarkistukset, ei että hakemisto hyväksyisi tai julkaisee sitä.