Specifikace obsahu informačního kanálu v partnerském centru MSN jsou navržené tak, aby zajistily efektivní a přesné ingestování, ověřování a publikování obsahu od partnerů. Tyto specifikace zahrnují různé aspekty správy obsahu, včetně podporovaných typů obsahu, formátů, pravidel metadat a pokynů pro udržování stavu a spolehlivosti informačního kanálu.
MSN podporuje:
-
Články, galerie a video
-
Zdroje informačního kanálu HTTPS. Důrazně doporučujeme používat protokol TLS/SSL.
MSN nepodporuje:
-
Odkazy obsahující uživatelská jména nebo hesla v prostředku nebo parametrech
-
Přidání IP adresy na seznam povolených
-
Statické IP adresy
V tomto článku
Pravidla metadat informačního kanálu
Články
Články jsou příspěvky, které se skládají z textu, obrázků a videí. Články nemusí obsahovat obrázky, ale automaticky se dají publikovat jenom články obsahující obrázky.
Galerie
Galerie jsou prezentace skládající se z obrázků a titulků. Galerie musí obsahovat vložené image, které se mají publikovat.
Video
Videa můžou být zveřejněny samostatně nebo zahrnuté do článků. Video příspěvek přijatý z vašeho informačního kanálu bude znovu hostovaný ve službě MSN, zatímco video hostované na webu třetí strany, jako je YouTube nebo DailyMotion, bude vloženo prostřednictvím hostování tohoto webu.
Videa hostovaná ve službě MSN budou generovat více přenosových rychlostí pro překódování více zařízení a adaptivní streamování.
Podporované formáty kontejneru videa
AVI, MPEG, MP4, WMV, M4V
Podporované videokodeky
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Podporované formáty zvuku
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Podporované protokoly
HTTP, FTP
Podporované přípony souborů
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Velikost videa
Doporučuje se, aby videa byla alespoň 720p, 3 Mb/s. Maximální velikost videosouboru je 2 GB. Příjem velkých souborů, jako jsou videa v rozlišení 4K nebo delší videa, může selhat.
Poznámka: Vertikální navýšení kapacity se nepodporuje, proto se doporučuje vysoká kvalita videosouborů.
Obrázky
Obrázky nemohou být samy o sobě příspěvky. Musí být vložené do článku nebo galerie nebo připojené k příspěvku videa jako miniatura.
Podporované formáty obrázků
WebP, PNG, JPG, GIF
Poznámka: Soubory GIF nelze použít jako miniatury obrázků. Jejich použití v hlavním obsahu se nedoporučuje kvůli omezené kvalitě.
Velikost obrázku
Obrázky v obsahu
Doporučuje se, aby obrázky byly alespoň 720 pixelů na výšku nebo šířku. Maximální velikost souboru obrázku je 15 MB. Obrázky můžou mít libovolný poměr stran, ale nemusí se zobrazit správně, pokud je poměr menší než 0,5 nebo větší než 1,89.
Miniatury
Miniatura je hlavní obrázek, který doprovází nadpis obsahu.
-
Doporučená velikost obrázku je 1200 × 624 px s minimálním rozlišením DPI 72.
-
Požadovaný poměr stran obrázku je 1,91:1.
-
Maximální velikost souboru by měla být 2 MB.
Sociální sítě
MSN podporuje vkládání z:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Kvést
-
Mapy Google
-
Giphy
-
Reddit
-
TikTok
Služba MSN doporučuje použít výchozí kód pro vložení, který poskytuje zdrojová lokalita. Kliknutím semzobrazíte příklady kódu pro vložení pro běžné weby sociálních médií.
Pravidla metadat informačního kanálu
-
Vydavatel musí mít distribuční práva pro veškerý obsah v informačním kanálu. Pokud vydavatel nemá oprávnění k syndikaci některých obrázků, MUSÍ nastavit "HasSyndicationRights" na false.
-
Všechny kanály musí být čerstvé a pravidelně se aktualizují, než se pustí do provozu.
-
Vlastní mapování není podporováno, všechna pole musí být zadána podle uvedených příkladů.
-
Koncové body partnera musí být statické nebo neměnné, pokud není potřeba vytvářet dynamické hodnoty, jako jsou segmenty tras, hodnoty řetězců dotazů a hodnoty hlaviček požadavků HTTP.
-
Všechny položky v informačním kanálu musí být nakonfigurované ve stejném jediném jazyce.
-
Kódování je ve výchozím nastavení UTF-8, pokud není ve značce XML uvedeno jinak. Informační kanály se smíšeným kódováním nebo se nepodaří ingestovat.
-
Informační kanály by neměly obsahovat žádné neplatné znaky bez uvozovek, například "&", "<", ">", dvojité uvozovky a jednoduché uvozovky. Položky s řídicími znaky se nepodaří ingestovat.
-
Společnost Microsoft může všechny odkazy primárně propagační povahy zbavit.
-
E-maily kontaktních osob vydavatele musí být uloženy, když je značka vydavatele na palubě, aby bylo možné vydavatele obsahu upozorňovat na problémy s živými weby, jako jsou zastaralé informační kanály.
Detekce změn informačního kanálu
Služba MSN ukládá prostředky během příjmu dat pouze zpracováním informačních kanálů s novým nebo aktualizovaným obsahem. Změny se dají označit dvěma způsoby:
Značky ETag protokolu HTTP
Vydavatelé můžou odeslat žádost s hlavičkou ETag, která funguje jako kontrolní součet pro obsah informačního kanálu. Značka se uloží do mezipaměti a odešle zpět v hlavičce If-None-Match při vyžádání informačního kanálu.
Naposledy změněno
Obsah odeslaný s hlavičkou Naposledy změněný se uloží do mezipaměti s následným požadavkem, který obdrží hlavičku If-Modified-Since . Servery informačních kanálů budou reagovat stavovým kódem 304, pokud od data poslední změny nebyly provedeny žádné změny.
Ověřování informačního kanálu
Ověřování informačního kanálu není povinné. Vydavatelé můžou ingestovat obsah jenom s adresou URL zdroje informačního kanálu, pokud si to přejí, ale MSN podporuje také základní ověřování a OAuth 2.0. Kliknutím sem zobrazíte graf s podrobnostmi o procesu příjmu informačního kanálu.
Základní ověřování
MSN podporuje základní ověřování podle rfc 7517. Pokud chcete do informačního kanálu přidat základní ověřování, zadejte:
-
Uživatelské jméno
-
Heslo
-
Adresa URL zabezpečeného informačního kanálu
OAuth 2.0
Pokud chcete do informačního kanálu přidat ověřování OAuth 2.0, zadejte:
-
Adresa URL serveru tokenů zabezpečení
-
Client_ID
-
Grant_Type
-
Obor (Volitelné, slouží k označení úrovně přístupu. Tato hodnota se odešle tak, jak je.)
-
Adresa URL zabezpečeného informačního kanálu
Kódování dokumentu
Msn ve výchozím nastavení používá kódování UTF-8. Toto nastavení můžete přepsat změnou atributu kódování uzlu prologu na platnou hodnotu kódování.
Podporované formáty informačních kanálů
MSN podporuje RSS, ATOM a některé podmnožina media RSS, Dublin Core a další obory názvů podrobně popsané v media RSS.
Velké informační kanály
Msn doporučuje udržovat vždy velikost informačního kanálu menší než 30 čerstvých položek, ale pomocí funkce stránkování informačních kanálů ATOM můžete povolit posuvný příjem oken informačního kanálu.
Omezení a zpracování chyb
Maximální velikost informačního kanálu je 10 MB a maximální velikost obrázku je 14 MB. Služba MSN automaticky aktivuje eskalaci, pokud je přijatý obsah starší než tři dny. Pokud máte jiné požadavky na věk obsahu, kontaktujte nás na PartnerHubSupport@microsoft.com. MSN se znovu pokusí o informační kanály s chybami, ale pokud chyby potrvají, budete upozorněni, abyste je prošetřili. Služba MSN automaticky vypne příjem obsahu z informačních kanálů, které zůstávají v chybovém stavu po delší dobu.
Rozšíření informačních kanálů o obory názvů
Slovník a termíny informačního kanálu můžete rozšířit v informačních kanálech založených na jazyce XML spolu s jejich doporučenou předponou. Služba MSN rozpoznává pouze elementy a atributy explicitně zadané v uvedených příkladech kódu. Všechny nepodporované obory názvů budou ignorovány.
|
Název rozšíření |
Prefix (Předpona) |
Obor názvů |
|---|---|---|
|
Informační kanál RSS médií |
multimédia |
http://search.yahoo.com/mrss/ |
|
Základní metadata Dublinu |
stejnosměrný proud |
http://purl.org/dc/elements/1.1/ |
|
Dublin – základní termíny |
dcterms |
http://purl.org/dc/terms/ |
|
Proprietární služby microsoftu pro příjem dat |
míle |
http://schemas.ingestion.microsoft.com/common/ |
