Az MSN Partner Hub hírcsatorna-tartalomspecifikációinak célja annak biztosítása, hogy a partnerektől származó tartalmakat hatékonyan és pontosan betöltse, érvényesítse és közzétehesse. Ezek a specifikációk a tartalomkezelés különböző aspektusaira vonatkoznak, beleértve a támogatott tartalomtípusokat, formátumokat, metaadatszabályokat, valamint a hírcsatorna állapotának és megbízhatóságának fenntartására vonatkozó irányelveket.
Az MSN a következőket támogatja:
-
Cikkek, galériák és videók
-
HTTPS-hírcsatorna forrásai. A TLS/SSL használata erősen ajánlott.
Az MSN nem támogatja a következőt:
-
Az erőforrásban vagy paraméterekben felhasználóneveket vagy jelszavakat tartalmazó hivatkozások
-
IP-engedélyezési lista
-
Statikus IP-címek
Tartalom
Adatcsatorna metaadatainak szabályai
Cikkek
A cikkek szövegből, képekből és videókból álló bejegyzések. A cikkeknek nem kell képekkel rendelkezniük, de csak a képeket tartalmazó cikkek tehetők automatikusan közzé.
Galériák
A galériák képekből és feliratokból álló diavetítések. A galériákban közzé kell tenni beágyazott képeket.
Videó
A videókat közzéteheti önállóan, vagy belefoglalhatja a cikkekbe. A hírcsatornából betöltött videóbemutatók az MSN-en lesznek tárolva, míg egy harmadik fél webhelyén( például a YouTube-on vagy a DailyMotionban) üzemeltetett videó az adott webhely tárhelyén lesz beágyazva.
Az MSN-en üzemeltetett videók több sávszélességet hoznak létre a többeszközes átkódoláshoz és az adaptív streameléshez.
Támogatott videotároló-formátumok
AVI, MPEG, MP4, WMV, M4V
Támogatott videokodekek
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Támogatott hangformátumok
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Támogatott protokollok
HTTP, FTP
Támogatott fájlkiterjesztések
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Videó mérete
A videóknak legalább 720p, 3 Mbps méretűnek kell lenniük. A videofájl maximális mérete 2 GB. A nagy méretű fájlok, például a 4K-s videók és a hosszabb videók betöltése meghiúsulhat.
Megjegyzés: A felskálázás nem támogatott, ezért a magas videofájl-minőség ajánlott.
Képek
A képek önmagukban nem tehetők közzé. Ezeket be kell ágyazni egy cikkbe vagy gyűjteménybe, vagy miniatűrként kell csatolni őket egy videóbemutatóhoz.
Támogatott képformátumok
WebP, PNG, JPG, GIF
Megjegyzés: A GIF-fájlok nem használhatók miniatűrképként. A fő tartalomban való használatuk a korlátozott minőség miatt nem ajánlott.
Kép mérete
Tartalomon belüli képek
Javasoljuk, hogy a képek magassága vagy szélessége legalább 720px legyen. A képfájl maximális mérete 15 MB. A képek bármilyen méretarányt tartalmazhatnak, de előfordulhat, hogy nem jelennek meg megfelelően, ha az arány kisebb, mint 0,5 vagy nagyobb, mint 1,89.
Miniatűrképek
A miniatűr kép a fő kép, amely a tartalom főcíméhez tartozik.
-
Az ajánlott képméret 1200x624px, minimális 72 DPI-vel.
-
A kívánt képarány 1,91:1
-
A maximális fájlméretnek 2 MB-nak kell lennie
Közösségi média
Az MSN a következő helyről támogatja a beágyazást:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Virul
-
Google Térkép
-
Giphy
-
Reddit
-
TikTok
Az MSN a forráswebhely által biztosított alapértelmezett beágyazási kód használatát javasolja. Kattintson idea gyakori közösségi webhelyek beágyazási kódjainak megtekintéséhez.
Adatcsatorna metaadatainak szabályai
-
A Publishernek terjesztési jogosultságokkal kell rendelkeznie a hírcsatornán belüli összes tartalomhoz. Ha a közzétevőnek nincs jogosultsága egyes képek szindikálására, a "HasSyndicationRights" értéket false (hamis) értékre kell állítania.
-
Az élő adás előtt minden hírcsatornának frissnek és rendszeresen frissülnie kell.
-
Az egyéni leképezés nem támogatott, minden mezőt meg kell adni az adott példáknak megfelelően.
-
A partnervégpontoknak statikusnak/változatlannak kell lenniük, ha nem szükséges dinamikus értékeket létrehozni, például útvonalszegmenseket, lekérdezési sztringértékeket és HTTP-kérésfejlécértékeket.
-
A hírcsatorna minden elemének ugyanabban a nyelven kell lennie, amely a hírcsatornához van konfigurálva.
-
A kódolás alapértelmezés szerint UTF-8, kivéve, ha az xml-címkében másként van megadva. A vegyes vagy kódolású hírcsatornák betöltése sikertelen lesz.
-
A hírcsatornák nem tartalmazhatnak feloldatlan tiltott karaktereket, például "&", "<", ">", dupla idézőjeleket és szimpla idézőjeleket. A vezérlőkarakterekbe nem lehet beolvasni az elemeket.
-
A Microsoft eltávolíthat minden olyan hivatkozást, amely elsősorban promóciós jellegű.
-
A közzétevő kapcsolattartói e-mailjeit akkor kell tárolni, amikor a közzétevő márkája be van léptetve a tartalom közzétevőjének értesítésére az élő webhelyekkel kapcsolatos problémákról, például elavult hírcsatornákról.
Hírcsatornaváltozások észlelése
Az MSN csak az új vagy frissített tartalommal rendelkező hírcsatornák feldolgozásával menti az erőforrásokat a betöltés során. A módosítások kétféleképpen jelölhetők meg:
HTTP ETagek
A közzétevők ETag fejléccel küldhetnek kérést, amely a hírcsatorna tartalmának ellenőrzőösszegeként működik. A rendszer gyorsítótárazza és visszaküldi a címkét az If-None-Match fejlécben a hírcsatorna kérése közben.
Utolsó módosítás
Az utoljára módosított fejléccel küldött tartalmak gyorsítótárazva lesznek, és a későbbi kérések if-modified-since fejlécet kapnak. A hírcsatorna-kiszolgálók 304-s állapotkóddal válaszolnak, ha az utolsó módosítás dátuma óta nem történt módosítás.
Hírcsatorna-hitelesítés
A hírcsatorna-hitelesítés nem szükséges. A közzétevők csak a hírcsatorna forrásÁNAK URL-címével tudják tartalommal ellátni a tartalmat, de az MSN támogatja az alapszintű hitelesítést és az OAuth 2.0-t is. Ide kattintva megtekintheti a hírcsatorna betöltési folyamatát részletező diagramot.
Alapszintű hitelesítés
Az MSN az RFC 7517-ben megadott alapszintű hitelesítést támogatja. Ha alapszintű hitelesítést szeretne hozzáadni a hírcsatornához, adja meg az alábbiakat:
-
Felhasználónév
-
Jelszó
-
Biztonságos hírcsatorna URL-címe
OAuth 2.0
Ha OAuth 2.0-hitelesítést szeretne hozzáadni a hírcsatornához, adja meg a következőt:
-
Biztonsági jogkivonat-kiszolgáló URL-címe
-
Client_ID
-
Grant_Type
-
Hatókör (Nem kötelező, a hozzáférési szint jelzésére szolgál. Ezt az értéket a rendszer a megadott módon küldi el.)
-
Biztonságos hírcsatorna URL-címe
Dokumentumkódolás
Az MSN alapértelmezés szerint UTF-8 kódolást használ. Ezt felülbírálhatja, ha a prolog csomópont kódolási attribútumát érvényes kódolási értékre módosítja.
Támogatott hírcsatorna-formátumok
Az MSN támogatja az RSS, az ATOM és a Media RSS, a Dublin Core és más, a Media RSS-ben részletezett névterek egyes részhalmazait.
Nagy hírcsatornák
Az MSN azt javasolja, hogy a hírcsatorna mérete mindig 30-nál kisebb legyen, de az ATOM hírcsatorna lapozási funkciójával engedélyezheti a csatorna csúszóablakos betöltését.
Korlátozások és hibakezelés
A hírcsatorna maximális mérete 10 MB , a maximális képméret pedig 14 MB. Az MSN automatikusan eszkalációt vált ki, ha a betöltött tartalom három napnál régebbi. Ha eltérő a tartalom korhatára, lépjen kapcsolatba velünk a PartnerHubSupport@microsoft.com. Az MSN újrapróbálkozik a hibás hírcsatornákkal, de ha a hibák továbbra is fennállnak, a rendszer értesítést küld a vizsgálathoz. Az MSN automatikusan kikapcsolja a tartalombetöltést azokról a hírcsatornákról, amelyek hosszabb ideig hibaállapotban maradnak.
Hírcsatornák kiterjesztése névtérekkel
Az XML-alapú hírcsatornákban bővítheti a hírcsatorna szókincsét és kifejezéseit az ajánlott előtaggal együtt. Az MSN csak a felsorolt példakódokban explicit módon megadott elemeket és attribútumokat ismeri fel. A rendszer figyelmen kívül hagyja a nem támogatott névtereket.
|
Bővítmény neve |
Prefix (Előtag) |
Névtér |
|---|---|---|
|
Média RSS-hírcsatorna |
médiatartalmak |
http://search.yahoo.com/mrss/ |
|
Dublin Core Metadata |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Dublini alapfogalmak |
dcterms |
http://purl.org/dc/terms/ |
|
Jogvédett Microsoft Ingestion Services |
mi |
http://schemas.ingestion.microsoft.com/common/ |
