Špecifikácie obsahu informačného kanála v centre pre partnerov MSN sú navrhnuté tak, aby sa zabezpečilo, že obsah od partnerov bude požitý, overený a publikovaný efektívne a presne. Tieto špecifikácie sa vzťahujú na rôzne aspekty správy obsahu vrátane podporovaných typov obsahu, formátov, pravidiel metaúdajov a pokynov na zachovanie stavu a spoľahlivosti informačných kanálov.
MsN podporuje:
-
Články, galérie a video
-
Zdroje informačného kanála HTTPS. Používanie protokolu TLS/SSL sa dôrazne odporúča.
MSN nepodporuje:
-
Prepojenia obsahujúce mená používateľov alebo heslá v zdroji alebo parametroch
-
Pridanie IP adresy do zoznamu povolených ip adries
-
Statické IP adresy
Obsah tohto článku
Pravidlá metaúdajov informačného kanála
Overovanie informačného kanála
Články
Články sú príspevky pozostávajúce z textu, obrázkov a videí. Články nemusia mať obrázky, ale automaticky publikovať môžu len články, ktoré obsahujú obrázky.
Galérie
Galérie sú prezentácie pozostávajúce z obrázkov a popisov. Galérie musia obsahovať vložené obrázky, ktoré sa majú publikovať.
Video
Videá je možné uverejňovať samostatne alebo v článkoch. Video príspevok požití z informačného kanála sa znova uloží na lokalite MSN, zatiaľ čo video hosťované na lokalite tretej strany, ako je napríklad YouTube alebo DailyMotion, sa vloží prostredníctvom hosťovania tejto lokality.
Videá hosťované na lokalite MSN vygenerujú viacero bitových rýchlosti pre prekódovanie a adaptívne streamovanie s viacerými zariadeniami.
Podporované formáty videokanála
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é prípony súborov
.mp4, .mpeg, .mpg, .wmv, .avi .m4v
Veľkosť videa
Videá sa odporúčajú mať aspoň 720p, 3Mbps. Maximálna veľkosť videosúboru je 2 GB. Veľké súbory, ako napríklad 4K videá a dlhšie videá, môžu zlyhať pri požití.
Poznámka: Upscaling nie je podporovaný, preto sa odporúča vysoká kvalita videosúborov.
Obrázky
Obrázky nemôžu byť príspevky na vlastnú päsť. Musia byť vložené do článku alebo galérie alebo musia byť priložené k video príspevku ako miniatúra.
Podporované formáty obrázkov
WebP, PNG, JPG, GIF
Poznámka: Obrázky GIF nie je možné použiť ako miniatúry. Ich použitie v hlavnom obsahu sa neodporúča z dôvodu obmedzenej kvality.
Veľkosť obrázka
Obrázky v obsahu
Odporúča sa, aby obrázky mali výšku alebo šírku aspoň 720 px. Maximálna veľkosť súboru s obrázkom je 15 MB. Obrázky môžu mať ľubovoľný pomer strán, ale nemusia sa zobraziť správne, ak je pomer menší ako 0,5 alebo väčší ako 1,89.
Miniatúry obrázkov
Obrázok miniatúry je hlavný obrázok, ktorý sprevádza nadpis obsahu.
-
Odporúčaná veľkosť obrázka je 1200 x 624 px, s minimálnou veľkosťou DPI 72.
-
Požadovaný pomer strán obrázka je 1,91:1
-
Maximálna veľkosť súboru by mala byť 2 MB
Sociálne médiá
MSN podporuje vkladanie z:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Prekvitať
-
Mapy Google
-
Giphy
-
Reddit
-
TikTok
MsN odporúča použiť predvolený vkladací kód poskytnutý zdrojovou lokalitou. Kliknutím semzobrazíte príklady vkladacieho kódu pre bežné lokality sociálnych médií.
Pravidlá metaúdajov informačného kanála
-
Program Publisher musí mať distribučné práva pre všetok obsah v informačnom kanáli. Ak vydavateľ nemá práva na združovanie niektorých obrázkov, musí nastaviť hodnotu HasSyndicationRights na hodnotu false.
-
Všetky informačné kanály musia byť pred živým prenosom čerstvé a pravidelne aktualizované.
-
Vlastné priradenie nie je podporované, všetky polia musia byť zadané podľa daných príkladov.
-
Koncové body partnera musia byť statické alebo nemenné, ak nie je potrebné vytvárať žiadne dynamické hodnoty, ako sú napríklad segmenty trás, hodnoty reťazca dotazu a hodnoty hlavičiek požiadaviek HTTP.
-
Všetky položky v informačnom kanáli musia byť v rovnakom jazyku nakonfigurovanom pre informačný kanál.
-
Kódovanie je predvolene UTF-8, pokiaľ nie je v značke XML uvedené inak. Informačné kanály so zmiešaným kódovaním alebo zmiešaným kódovaním sa nebudú dať používať.
-
Informačné kanály by nemali obsahovať žiadne neuniknuté neplatné znaky, ako napríklad "&", "<", ">", dvojité úvodzovky a jednoduché úvodzovky. Položky so znakmi ovládacieho prvku sa nebudú dať používať.
-
Spoločnosť Microsoft môže vyzliecť všetky prepojenia predovšetkým propagačného charakteru.
-
E-maily s kontaktnými osobami programu Publisher sa musia uložiť, keď je zastaraná značka vydavateľa, aby sa mohli použiť na informovanie vydavateľa obsahu o problémoch so živou lokalitou, ako sú napríklad zastarané informačné kanály.
Zisťovanie zmien informačného kanála
MsN ukladá zdroje počas požitia iba spracovaním informačných kanálov, ktoré obsahujú nový alebo aktualizovaný obsah. Zmeny možno označiť dvomi spôsobmi:
Značky HTTP
Vydavatelia môžu odoslať žiadosť s hlavičkou značky ETag, ktorá funguje ako kontrolný súčet obsahu informačného kanála. Značka sa uloží do vyrovnávacej pamäte a odošle sa späť do hlavičky If-None-Match počas vyžiadania informačného kanála.
Naposledy upravené
Obsah odoslaný s hlavičkou poslednej úpravy sa uloží do vyrovnávacej pamäte, pričom ďalšia požiadavka dostane hlavičku If-Modified-Since . Servery informačných kanálov budú reagovať so stavovým kódom 304, ak sa od dátumu poslednej úpravy nevykonali žiadne zmeny.
Overovanie informačného kanála
Overovanie informačného kanála sa nevyžaduje. Vydavatelia môžu ingest obsah s ničím viac ako zdroj URL informačného kanála, ak si to želajú, ale MSN tiež podporuje základné overovanie a OAuth 2.0. Kliknutím sem zobrazíte graf s podrobnosťami o procese požitia informačného kanála.
Základné overenie
MSN podporuje základné overovanie tak, ako je uvedené v RFC 7517. Ak chcete do informačného kanála pridať základné overovanie, zadajte:
-
Meno používateľa
-
Heslo
-
URL adresa zabezpečeného informačného kanála
OAuth 2.0
Ak chcete do informačného kanála pridať overenie OAuth 2.0, zadajte:
-
URL adresa servera tokenov zabezpečenia
-
Client_ID
-
Grant_Type
-
Rozsah (voliteľné, používa sa na označenie úrovne prístupu. Táto hodnota sa odošle tak, ako je.)
-
URL adresa zabezpečeného informačného kanála
Kódovanie dokumentu
MsN predvolene používa kódovanie UTF-8. Môžete to prepísať zmenou atribútu kódovania uzla prolog na platnú hodnotu kódovania.
Podporované formáty informačných kanálov
MsN podporuje rss, ATOM, a niektoré podmnožiny Media RSS, Dublin Core, a ďalšie priestory názvov podrobne v Médiá RSS.
Veľké informačné kanály
MSN odporúča zachovať veľkosť informačného kanála menej ako 30 čerstvých položiek po celý čas, ale môžete použiť funkciu stránkovania informačného kanála ATOM na povolenie požitia informačného kanála posuvnými oknami.
Limity a spracovanie chýb
Maximálna veľkosť informačného kanála je 10 MB a maximálna veľkosť obrázka je 14 MB. MsN automaticky spustí eskaláciu, ak má požitie obsahu viac ako tri dni. Ak máte rôzne požiadavky na vek obsahu, kontaktujte nás na PartnerHubSupport@microsoft.com. MSN znova pokúsi informačné kanály, ktoré obsahujú chyby, ale ak chyby pretrvávajú, budete upozornení na preskúmanie. MSN automaticky vypne príjem obsahu z informačných kanálov, ktoré zostávajú v chybovom stave po dlhšiu dobu.
Rozšírenie informačných kanálov o priestory názvov
Môžete rozšíriť slovnú zásobu informačného kanála a výrazy v informačných kanáloch založených na formáte XML spolu s ich odporúčanou predponou. MSN rozpozná iba prvky a atribúty explicitne špecifikované v uvedených príkladoch kódu. Všetky nepodporované priestory názvov sa budú ignorovať.
|
Názov rozšírenia |
Predpona |
priestor názvov |
|---|---|---|
|
Médiá RSS |
médiá |
http://search.yahoo.com/mrss/ |
|
Základné metaúdaje Dublin |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Dublin Core – podmienky |
dcterms |
http://purl.org/dc/terms/ |
|
Proprietárne služby Microsoft Ingestion Services |
mi |
http://schemas.ingestion.microsoft.com/common/ |
