"MSN" partnerių telkinio informacijos santraukos turinio specifikacijos skirtos užtikrinti, kad partnerių turinys būtų įsisavintas, patikrintas ir publikuojamas efektyviai ir tiksliai. Šios specifikacijos apima įvairius turinio valdymo aspektus, įskaitant palaikomus turinio tipus, formatus, metaduomenų taisykles ir gaires, kaip išlaikyti informacijos santraukos sveikatą ir patikimumą.
MSN palaiko:
-
Straipsniai, galerijos ir vaizdo įrašai
-
HTTPS informacijos santraukos šaltiniai. Primygtinai rekomenduojama naudoti TLS/SSL.
MSN nepalaiko:
-
Saitai su vartotojo vardais arba slaptažodžiais ištekliuje arba parametruose
-
IP baltųjų sąrašų parengimas
-
Statiniai IP
Šiame straipsnyje:
Informacijos santraukos metaduomenų taisyklės
Informacijos santraukos autentifikavimas
Palaikomi informacijos santraukos formatai
Didelės informacijos santraukos
Straipsniai
Straipsniai yra įrašai, sudaryti iš teksto, vaizdų ir vaizdo įrašų. Straipsniuose nebūtina turėti vaizdų, tačiau galima automatiškai publikuoti tik straipsnius, kuriuose yra vaizdų.
Galerija
Galerijos – tai skaidrių demonstracijos, kurias sudaro vaizdai ir antraštės. Galerijose turi būti įdėtųjų vaizdų, kuriuos reikia publikuoti.
Vaizdas
Vaizdo įrašus galima paskelbti patiems arba įtraukti į straipsnius. Iš jūsų informacijos santraukos gautas vaizdo įrašo įrašas bus nuomojamas MSN, o vaizdo įrašas, laikomas trečiosios šalies svetainėje, pvz., "YouTube" arba "DailyMotion", bus įdėtas per tos svetainės išteklių nuomą.
MSN nuomojami vaizdo įrašai sugeneruos kelis bitų dažnius kelių įrenginių transkodavimo ir adaptyviojo srautinio perdavimo funkcijai.
Palaikomi vaizdo įrašų konteinerių formatai
AVI, MPEG, MP4, WMV, M4V
Palaikomi vaizdo kodekai
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Palaikomi garso formatai
AC-3 ("Dolby Digital"), AAC, MP3, "Windows Media Audio"
Palaikomi protokolai
HTTP, FTP
Palaikomi failų plėtiniai
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Vaizdo įrašo dydis
Rekomenduojama, kad vaizdo įrašai būtų bent 720 p, 3 Mbps. Maksimalus vaizdo įrašo failo dydis yra 2 GB. Didelių failų, pvz., 4K vaizdo įrašų ir ilgesnių vaizdo įrašų, gali nepavykti įvesti.
Pastaba: Upscaling is not supported, so high video file quality is recommended.
Atvaizdai
Vaizdai negali būti savais įrašais. Jie turi būti įdėti į straipsnį ar galeriją arba pridėti prie vaizdo įrašo kaip miniatiūra.
Palaikomi vaizdo formatai
WebP, PNG, JPG, GIF
Pastaba: GIF negalima naudoti kaip miniatiūrų vaizdų. Jų naudojimas pagrindiniame turinyje nerekomenduojamas dėl ribotos kokybės.
Vaizdo dydis
Turinio vaizdai
Rekomenduojama, kad vaizdų aukštis arba plotis būtų bent 720 px. Maksimalus vaizdo failo dydis yra 15 MB. Vaizdai gali būti bet kokio formato, bet gali būti rodomi netinkamai, jei jų santykis yra mažesnis už 0,5 arba didesnis už 1,89.
Miniatiūrų vaizdai
Miniatiūros vaizdas yra pagrindinis vaizdas, pridedamas prie turinio antraštės.
-
Rekomenduojamas vaizdo dydis yra 1 200 x 624 px, mažiausias DPI – 72.
-
Norimas vaizdo vaizdo formatas yra 1,91:1
-
Maksimalus failo dydis turi būti 2MB
Socialinė medija
MSN palaiko įdėjimo iš:
-
Twitter
-
Facebook
-
Instagram
-
"Pinterest"
-
Infogram
-
Spotify
-
Klestėti
-
Google Maps
-
Giphy
-
"Reddit"
-
TikTok
MSN rekomenduoja naudoti numatytąjį įdėjimo kodą, pateiktą šaltinio svetainėje. Spustelėkite čia, kad pamatytumėte įprastų socialinės medijos svetainių įdėjimo kodo pavyzdžius.
Informacijos santraukos metaduomenų taisyklės
-
Publisher turi turėti viso informacijos santraukos turinio platinimo teises. Jei leidėjas neturi teisių sindikuoti kai kuriuos vaizdus, jis TURI nustatyti "HasSyndicationRights" kaip klaidinga.
-
Prieš pradedant gyventi, visos informacijos santraukos turi būti šviežios ir reguliariai atnaujinamos.
-
Pasirinktinis susiejimas nepalaikomas, visi laukai turi būti nurodyti kaip pateikti pavyzdžiai.
-
Partnerių galiniai punktai turi būti statiniai / unchanging, kai nereikalaujama kurti dinaminių reikšmių, pvz., maršruto segmentų, užklausos eilučių reikšmių ir HTTP užklausos antraštės reikšmių.
-
Visi informacijos santraukos elementai turi būti tos pačios kalbos, sukonfigūruotos informacijos santraukai.
-
Kodavimas yra UTF-8 pagal numatytuosius nustatymus, nebent XML žymėje nurodyta kitaip. Informacijos santraukų su mišraus arba kodavimo nepavyksta įsisavinti.
-
Informacijos santraukose neturėtų būti neleistinų simbolių, pvz., "&", "<", ">", dvigubų kabučių ir viengubų kabučių. Elementų su valdiklio simboliais nepavyks įsisavinti.
-
"Microsoft" gali nutraukti bet kokius pirmiausia reklaminio pobūdžio saitus.
-
"Publisher" kontaktinių asmenų el. laiškai turi būti saugomi, kai leidėjo prekės ženklas yra įlaipinamas naudoti pranešant turinio leidėjui apie tiesiogines svetainės problemas, pvz., pasenusias informacijos santraukas.
Informacijos santraukos keitimo aptikimas
MSN įrašo išteklius įdėjus, tik apdorodama informacijos santraukas, kuriose yra naujo arba atnaujinto turinio. Keitimus galima pažymėti dviem būdais:
HTTP ETags
Leidėjai gali siųsti užklausą su ETag antrašte, kuri veikia kaip informacijos santraukos turinio kontrolinė suma. Ši žymė bus į talpyklą perkelta ir išsiųsta atgal į antraštę Jei nėra atitikmens , kai bus prašoma informacijos santraukos.
Paskutinį kartą modifikuota
Turinys, siunčiamas su antrašte Paskutinį kartą modifikuota , bus laikomas talpykloje, o vėlesnė užklausa gaus antraštę If-Modified-Since . Informacijos santraukų serveriai atsakys su 304 būsenos kodu, jei po paskutinio modifikavimo datos nebuvo atlikta jokių pakeitimų.
Informacijos santraukos autentifikavimas
Informacijos santraukos autentifikavimas nebūtinas. Leidėjai gali įsisavinti turinį ne daugiau kaip informacijos santraukos šaltinio URL, jei to pageidauja, tačiau MSN taip pat palaiko bazinį autentifikavimą ir "OAuth 2.0". Spustelėkite čia, kad pamatytumėte diagramą, išsamiai apibūdinančią informacijos santraukos įdėjimo procesą.
Pagrindinis autentifikavimas
MSN palaiko bazinį autentifikavimą, kaip nurodyta RFC 7517. Norėdami į savo informacijos santrauką įtraukti bazinį autentifikavimą, pateikite:
-
Vartotojo vardas
-
Slaptažodis
-
Apsaugotos informacijos santraukos URL
OAuth 2.0
Norėdami įtraukti "OAuth 2.0" autentifikavimą į savo informacijos santrauką, pateikite:
-
Saugos atpažinimo ženklo serverio URL
-
Client_ID
-
Grant_Type
-
Aprėptis (pasirinktinai, naudojama nurodyti prieigos lygį. Ši reikšmė bus išsiųsta tokia, kokia yra.)
-
Apsaugotos informacijos santraukos URL
Dokumento kodavimas
MSN naudoja UTF-8 kodavimą pagal numatytuosius parametrus. Galite perrašyti šį parametrą pakeisdami prolog mazgo kodavimo atributą tinkama kodavimo reikšme.
Palaikomi informacijos santraukos formatai
MSN palaiko RSS, ATOM ir kai kuriuos medijos RSS, Dublin Core ir kitų vardų sričių pogrupius, išsamiai aprašytus medijos RSS.
Didelės informacijos santraukos
MSN rekomenduoja išlaikyti mažiau nei 30 šviežių elementų informacijos santraukos dydį visą laiką, tačiau galite naudoti ATOM puslapių kaitos funkciją, kad įjungtumėte stumdomą langą prarijus savo informacijos santrauką.
Apribojimai ir klaidų apdorojimas
Maksimalus informacijos santraukos dydis yra 10 MB , didžiausias vaizdo dydis – 14 MB. MSN automatiškai paleidžia eskalavimą, jei įsisavintas turinys yra senesnis nei trijų dienų. Jei taikomi kitokie turinio amžiaus reikalavimai, susisiekite su mumis PartnerHubSupport@microsoft.com. MSN iš naujo bando informacijos santraukas, kuriose yra klaidų, bet jei klaidos kartosis, jums bus pranešta ištirti. MSN automatiškai išjungia turinio įtraukimą iš informacijos santraukų, kurios ilgą laiką lieka klaidos būsenoje.
Sričių išplėtimas naudojant vardų sritis
Galite išplėsti žodyną ir terminus XML pagrindu veikiančiose informacijos santraukose kartu su jų rekomenduojamu prefiksu. MSN atpažįsta tik elementus ir atributus, aiškiai nurodytus pateiktuose kodų pavyzdžiuose. Bet kokios nepalaikomos vardų srities bus nepaisoma.
|
Plėtinio pavadinimas |
Priešdėlis |
Vardų sritis |
|---|---|---|
|
Medijos RSS |
medija |
http://search.yahoo.com/mrss/ |
|
Dublino pagrindinių metaduomenų |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Dublino pagrindinės sąlygos |
dcterms |
http://purl.org/dc/terms/ |
|
Patentuotos "Microsoft Ingestion Services" |
Mi |
http://schemas.ingestion.microsoft.com/common/ |
