Specifikacije vsebine vira v središču za partnerje MSN so zasnovane tako, da zagotavljajo učinkovito in natančno uporabo, preverjanje veljavnosti in objavljanje vsebine partnerjev. Te specifikacije pokrivajo različne vidike upravljanja vsebine, vključno s podprtimi vrstami vsebine, oblikami zapisa, pravili metapodatkov in smernicami za vzdrževanje ustreznosti stanja in zanesljivosti virov.
MSN podpira:
-
Članki, galerije in videoposnetki
-
Viri vira HTTPS. Priporočamo uporabo protokola TLS/SSL.
MSN ne podpira:
-
Povezave, ki vsebujejo uporabniška imena ali gesla v viru ali parametrih
-
Dodajanje na beli seznam naslovov IP
-
Statični IP-ji
V tem članku
Pravila za podajanje metapodatkov
Članki
Članki so objave, ki so sestavljene iz besedila, slik in videoposnetkov. Ni treba, da so v člankih slike, lahko pa so samodejno objavljeni le članki, ki vsebujejo slike.
Galerije
Galerije so diaprojekcije, sestavljene iz slik in napisov. Galerije morajo imeti vdelane slike, če jih želite objaviti.
Videoposnetek
Videoposnetke je mogoče objavljati sami ali jih vključiti v članke. V storitvi MSN bo znova gostovana objava v videoposnetku, ki gostuje na spletnem mestu drugega ponudnika, kot sta YouTube ali DailyMotion, pa bo vdelana prek gostovanja tega spletnega mesta.
Videoposnetki, ki gostujejo v storitvi MSN, ustvarijo več bitnih ponovitev za transkodiranje več naprav in prilagodljivo pretakanje.
Podprte oblike vsebnika videoposnetkov
AVI, MPEG, MP4, WMV, M4V
Podprti videokodeki
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Podprte oblike zapisa zvoka
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Podprti protokoli
HTTP, FTP
Podprte datotečne pripone
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Velikost videoposnetka
Priporočamo, da so videoposnetki vsaj 720p, 3 Mbps. Največja velikost videodatoteka je 2 GB. Velike datoteke, kot so videoposnetki ločljivosti 4K in daljši videoposnetki, morda ne bodo na voljo.
Opomba: Upscaling ni podprt, zato priporočamo visoko kakovost videodatoteka.
Slike
Slik ne morete objavljati sami. Vdelani morajo biti v članek ali galerijo ali pa morajo biti priloženi objavi videoposnetka kot sličica.
Podprte oblike zapisa slik
WebP, PNG, JPG, GIF
Opomba: GIF-ov ni mogoče uporabiti kot sličice. Njihova uporaba v glavni vsebini zaradi omejene kakovosti ni priporočljiva.
Velikost slike
Slike vsebine
Priporočljivo je, da so slike po višini ali širini vsaj 720 slikovnih pik. Največja velikost slikovne datoteke je 15 MB. Slike so lahko poljubno razmerje višina/širina, vendar morda ne bodo prikazane pravilno, če je razmerje manjše od 0,5 ali večje od 1,89.
Sličice
Sličica je glavna slika, ki spremlja naslov vsebine.
-
Priporočena velikost slike je 1200 x 624 slikovnih pik, z najmanjšo velikostjo DPI 72.
-
Želeno razmerje višina/širina slike je 1,91:1
-
Največja velikost datoteke mora biti 2 MB
Družabna omrežja
MSN podpira vdelave iz:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Razcvet
-
Google Zemljevidi
-
Giphy
-
Reddit (Reddit)
-
TikTok
MSN priporoča uporabo privzete vdelane kode, ki jo zagotavlja izvorno spletno mesto. Kliknite tukaj,če si želite ogledati primere vdelane kode za pogosta spletna mesta družabnih omrežij.
Pravila za podajanje metapodatkov
-
Publisher mora imeti pravice za distribucijo za vso vsebino v viru. Če izdajatelj nima pravic za združevanje nekaterih slik, morajo nastaviti »HasSyndicationRights« na »false«.
-
Preden se hranijo v živo, morajo biti vsi krmi sveži in se redno posodabljati.
-
Preslikava po meri ni podprta, vsa polja morajo biti določena glede na navedene primere.
-
Končne točke partnerja morajo biti statične/nespremenljive, če ni treba ustvariti nobenih dinamičnih vrednosti, kot so segmenti usmerjanja, vrednosti nizov poizvedbe in vrednosti glave zahteve HTTP.
-
Vsi elementi v viru morajo biti za vir konfigurirani v istem jeziku.
-
Kodiranje je privzeto UTF-8, razen če je v oznaki XML navedeno drugače. Feeds with mixed or encoding will fail to ingest.
-
V virih ne sme biti nobenih nelegalnih nelegalnih znakov, kot so »&«, »<«, »>«, dvojni narekovaji in enojni narekovaji. Elementi s kontrolnimi znaki ne bodo zaujši.
-
Microsoft lahko odstrani vse povezave, ki so v prvi vrsti promocijske narave.
-
E-poštna sporočila oseb za stik v Publisherju je treba shraniti, ko je na voljo blagovna znamka izdajatelja, da izdajatelja vsebine obvesti o težavah z mestom v živo, kot so zastareli viri.
Zaznavanje sprememb vira
MSN shrani vire med zaužitjem le z obdelavo virov, ki imajo novo ali posodobljeno vsebino. Spremembe lahko označite z zastavico na dva načina:
Oznake HTTP
Izdajatelji lahko pošljejo zahtevo z glavo ETag, ki deluje kot kontrolna vsota za vsebino vira. Oznaka bo predpomnjena in poslana nazaj v glavo If-None-Match , medtem ko zahteva vir.
Zadnja sprememba
Vsebina, poslana z glavo »Nazadnje spremenjeno «, bo predpomnjena, pri tem pa bodo nadaljnje zahteve poslane v glavo »Če je spremenjeno – od «. Feed servers will respond with a 304 status code if no changes made since the last modified date.
Preverjanje pristnosti vira
Preverjanje pristnosti vira ni potrebno. Založniki lahko vsebino dodajo le z URL-jem vira, če želijo, vendar MSN podpira tudi osnovno preverjanje pristnosti in OAuth 2.0. Kliknite tukaj, če si želite ogledati grafikon s podrobnostmi postopka za prebavo vira.
Osnovno preverjanje pristnosti
MSN podpira osnovno preverjanje pristnosti, kot je določeno v RFC 7517. Če želite v vir dodati osnovno preverjanje pristnosti, vnesite:
-
Uporabniško ime
-
Geslo
-
URL zavarovanega vira
OAuth 2,0
Če želite v vir dodati preverjanje pristnosti OAuth 2.0, vnesite:
-
URL strežnika varnostnega žetona
-
Client_ID
-
Grant_Type
-
Obseg (Izbirno, ki se uporablja za označevanje ravni dostopa. Ta vrednost bo poslana, kot je.)
-
URL zavarovanega vira
Kodiranje dokumenta
MSN privzeto uporablja kodiranje UTF-8. To lahko preglasite tako, da atribut kodiranja prolognega vozlišča spremenite v veljavno kodno vrednost.
Podprte oblike zapisa virov
MSN podpira RSS, ATOM in nekatere podnabore Rss Media, Dublin Core in druge imenski prostori, ki so podrobneje na voljo v virih Media RSS.
Veliki viri
MSN priporoča, da ohranite velikost vira, ki je manjša od 30 svežih elementov, vendar pa lahko s funkcijo ostranjevalnika vira ATOM omogočite, da drsno okno zavlačuje vaš vir.
Omejitve in obravnavanje napak
Največja velikost vira je 10 MB, največja velikost slike pa 14 MB. MSN samodejno sproži stopnjevanje, če je prežeta vsebina stara več kot tri dni. Če imate različne zahteve glede starosti vsebine, stopite v stik z nami na PartnerHubSupport@microsoft.com. MSN znova poskusi vire z napakami, toda če napake ne morete odpraviti, vas bomo o tem obvestili. MSN samodejno izklopi zaužitje vsebine iz virov, ki dlje časa ostanejo v stanju napake.
Razširjanje virov z imenskih prostorih
Besedišče in izraze vira lahko razširite v virih, ki temeljijo na XML-jih, skupaj s priporočeno predpono. MSN prepozna le elemente in atribute, ki so izrecno navedeni v primerih navedene kode. Kateri koli nepodprt imenski prostor bo prezrti.
|
Ime razširitve |
Predpona |
Imenski prostor |
|---|---|---|
|
Rss za predstavnost |
predstavnost |
http://search.yahoo.com/mrss/ |
|
Dublin Core Metadata |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Osnovni pogoji za Dublin |
dcterms |
http://purl.org/dc/terms/ |
|
Lastniške Microsoftove storitve za prebavo |
mi |
http://schemas.ingestion.microsoft.com/common/ |
