MSN-i partnerikeskuse kanalisisu spetsifikatsioonid on mõeldud partneritelt pärineva sisu tõhusamaks ja täpsemaks avaldamiseks. Need tehnilised andmed hõlmavad sisuhalduse erinevaid aspekte, sealhulgas toetatud sisutüüpe, vorminguid, metaandmete reegleid ning kanali seisundi ja töökindluse säilitamise juhiseid.
MSN toetab:
-
Artiklid, galeriid ja video
-
HTTPS-kanali allikad. Tungivalt soovitatav on kasutada TLS/SSL-i.
MSN ei toeta:
-
Ressursis või parameetrites kasutajanimesid või paroole sisaldavad lingid
-
IP-aadresside valgendamine
-
Staatilised IP-d
Selle artikli teemad
Artiklid
Artiklid on tekstist, piltidest ja videotest koosnevad postitused. Piltide lisamiseks pole vaja artikleid, kuid automaatselt saab avaldada ainult pilte sisaldavaid artikleid.
Galeriid
Galeriid on slaidiseansid, mis koosnevad piltidest ja pealdistest. Galeriidel peavad olema avaldatavad manustatud pildid.
Video
Videoid saab postitada eraldi või lisada artiklitesse. TEIE kanalist allalaaditud videopostitus majutatakse MSN-is uuesti, kolmanda osapoole saidil (nt YouTube'is või DailyMotionis) majutatud video manustatakse selle saidi majutusteenuse kaudu.
MSN-is majutatavad videod genereerivad mitme seadme transkodeerimiseks ja adaptiivseks voogesituseks mitu bittraiti.
Toetatud videoümbrisevormingud
AVI, MPEG, MP4, WMV, M4V
Toetatud videokodekid
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Toetatud helivormingud
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Toetatud protokollid
HTTP, FTP
Toetatud faililaiendid
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Video suurus
Videod on soovitatavad vähemalt 720 pikslit ja 3 Mbit/s. Videofaili mahu ülempiir on 2 GB. Suurte failide (nt 4K-videod ja pikemad videod) allalaadimine võib nurjuda.
Märkus.: Ülesmastaapimist ei toetata, seega on soovitatav kvaliteetne videofail.
Pildid
Pilte ei saa ise postitada. Need tuleb manustada artiklisse või galeriisse või manustada videopostitusele pisipildina.
Toetatud pildivormingud
WebP, PNG, JPG, GIF
Märkus.: GIF-pilte ei saa kasutada pisipiltidena. Nende kasutamine põhisisus ei ole piiratud kvaliteedi tõttu soovitatav.
Pildi suurus
Sisusisesed pildid
Piltide kõrgus või laius on soovitatav vähemalt 720 pikslit. Pildifaili mahu ülempiir on 15 MB. Pildid võivad olla mis tahes proportsioonid, kuid neid ei pruugita õigesti kuvada, kui suhe on väiksem kui 0,5 või suurem kui 1,89.
Pisipildid
Pisipilt on põhipilt, mis lisatakse sisu pealkirjale.
-
Soovitatav pildisuurus on 1200x624px, vähim DPI on 72.
-
Soovitud pildi proportsioonid on 1,91:1
-
Failimahu ülempiir peaks olema 2 MB
Sotsiaalmeedia
MSN toetab manustamisalusid:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Areneda
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN soovitab kasutada lähtesaidilt saadud manustamise vaikekoodi. Levinud suhtlusvõrgustike saitide manustamiskoodi näidete kuvamiseks klõpsake siin.
Kanali metaandmete reeglid
-
Publisher peab omama kanali kogu sisu levitamise õigusi. Kui avaldajal pole õigust teatud pilte sünteesida, peavad nad määrama sätte "HasSyndicationRights" väärtuseks väär.
-
Kõik söödad peavad enne elama hakkamist olema värsked ja regulaarselt värskendatud.
-
Kohandatud vastendust ei toetata, kõik väljad tuleb määrata vastavalt antud näidetele.
-
Partneri lõpp-punktid peavad olema staatilised/muutumatud, kui ei nõuta dünaamiliste väärtuste (nt protsessisegmentide, päringustringide väärtuste ja HTTP-päringupäise väärtuste) koostamist.
-
Kõik kanali üksused peavad olema kanali jaoks konfigureeritud samas keeles.
-
Kodeering on vaikimisi UTF-8, kui XML-sildis pole määratud teisiti. Segatud või kodeeritud kanalite allalaadimine nurjub.
-
Kanalid ei tohi sisaldada paotamatuid lubamatuid märke (nt "&", "<", ">", jutumärke ja üksikjutumärke). Juhtmärkidega üksuste sisseostmine nurjub.
-
Microsoft võib välja viia mis tahes peamiselt reklaamlingid.
-
Publisheri kontaktisikute meilisõnumid tuleb salvestada siis, kui väljaandja kaubamärk on tahvlil, et teavitada sisu väljaandjat reaalajas saidi probleemidest (nt aegunud kanalid).
Kanalimuudatuse tuvastamine
MSN salvestab ressursid allaneelamise ajal, töötledes ainult uue või värskendatud sisuga kanaleid. Muudatusi saab lipuga märkida kahel viisil.
HTTP-sildid
Publisherid saavad saata taotluse koos E-posti päisega, mis toimib kanali sisu kontrollsummana. Silt salvestatakse vahemällu ja saadetakse kanali taotlemisel tagasi päisesse If-None-Match .
Viimati muudetud
Päisega Viimati muudetud saadetud sisu talletatakse vahemällu ja sellele järgnevale päringule saadetakse päis If-Modified-Since. Kanaliserverid vastavad olekukoodiga 304, kui pärast viimast muutmiskuupäeva pole muudatusi tehtud.
Kanali autentimine
Kanali autentimine pole nõutav. Publisherid saavad soovi korral alla võtta ainult kanaliallika URL-iga sisu, kuid MSN toetab ka elementaarautentimist ja rakendust OAuth 2.0. Kanali allalaadimisprotsessi üksikasjaliku diagrammi kuvamiseks klõpsake siin.
Elementaarautentimine
MSN toetab elementaarautentimist, nagu on määratud RFC 7517-s. Kanalile elementaarautentimise lisamiseks tehke järgmist.
-
Kasutajanimi
-
Parool
-
Turvalise kanali URL
OAuth 2.0
Kanalisse OAuth 2.0 autentimise lisamiseks tehke järgmist.
-
Turbelubade serveri URL
-
Client_ID
-
Grant_Type
-
Ulatus (valikuline, kasutatakse pääsutaseme tähistamiseks. See väärtus saadetakse praegusel kujul.)
-
Turvalise kanali URL
Dokumendi kodeering
MSN kasutab vaikimisi UTF-8 kodeeringut. Saate selle alistada, muutes prolog-sõlme kodeerimisatribuudi kehtivaks kodeerimisväärtuseks.
Toetatud kanalivormingud
MSN toetab RSS-i, ATOM-i ja teatud Media RSS-i, Dublin Core'i ja muude nimeruumide alamhulki, mida kirjeldatakse jaotises Media RSS.
Suured kanalid
MSN soovitab kogu aeg säilitada vähem kui 30 värsket üksust, kuid saate kasutada ATOM-i kanali saalimise funktsiooni, et lubada kanali liustik.
Piirangud ja tõrketöötlus
Suurim lubatud kanalimaht on 10 MB ja pildi maksimaalne maht 14 MB. MSN käivitab automaatselt eskaleerimise, kui allalaaditud sisu on üle kolme päeva vana. Kui teil on teistsugused sisu vanusenõuded, võtke meiega ühendust aadressil PartnerHubSupport@microsoft.com. MSN proovib uuesti tõrkeid sisaldavaid kanaleid, kuid kui tõrked püsivad, teavitatakse teid uurimisest. MSN lülitab automaatselt välja sisu allaneelamise kanalitest, mis jäävad pikemaks ajaks tõrkeolekusse.
Nimeruumidega kanalite laiendamine
Xml-põhistes kanalites saate laiendada kanali sõnavara ja termineid koos nende soovitatud eesliitega. MSN tuvastab ainult loetletud koodinäidetes selgesõnaliselt määratud elemente ja atribuute. Kõiki toetuseta nimeruume ignoreeritakse.
|
Laiendi nimi |
Prefix (Eesliide) |
Nimeruum |
|---|---|---|
|
Meediumi RSS |
meedia |
http://search.yahoo.com/mrss/ |
|
Dublini põhi metaandmed |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Dublini põhitingimused |
dcterms |
http://purl.org/dc/terms/ |
|
Proprietary Microsoft Ingestion Services |
Mi |
http://schemas.ingestion.microsoft.com/common/ |
