Специфікації вмісту каналу в Центрі партнерів MSN призначені для забезпечення ефективної та точної публікації вмісту від партнерів. Ці специфікації охоплюють різні аспекти керування вмістом, зокрема підтримувані типи вмісту, формати, правила метаданих і рекомендації щодо підтримання справності та надійності каналу.
MsN підтримує:
-
Статті, галереї та відео
-
Джерела каналів HTTPS. Рекомендовано використовувати протокол TLS/SSL.
MSN не підтримує:
-
Посилання, які містять імена користувачів або паролі в ресурсі або параметрах
-
Список IP-адрес
-
Статичні IP-адреси
У цій статті
Статті
Статті – це дописи, що складаються з тексту, зображень і відео. Статті не обов'язково мають містити зображення, але можна автоматично публікувати лише статті із зображеннями.
Галереї
Колекції – це покази слайдів, які складаються із зображень і підписів. Для публікації колекцій мають бути вбудовані зображення.
Відео
Відео можна опублікувати самостійно або включити в статті. Відеопошта, отримане з вашого каналу, буде повторно розміщено в MSN, а відео, розміщене на сайті сторонніх постачальників, наприклад YouTube або DailyMotion, буде вбудовано через розміщення цього сайту.
Відео, розміщене на MSN, створить кілька бітів для передавання та адаптивного потокового передавання на кількох пристроях.
Підтримувані формати контейнера відео
AVI, MPEG, MP4, WMV, M4V
Підтримувані відеокодеки
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Підтримувані аудіоформати
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Підтримувані протоколи
HTTP, FTP
Підтримувані розширення файлів
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Розмір відео
Відео рекомендується мати принаймні 720p, 3Mbps. Максимальний розмір відеофайлу – 2 ГБ. Великі файли, наприклад відео з 4K і довші відео, можуть не ввійти.
Примітка.: Перетворення на формат UPSCAL НЕ підтримується, тому рекомендовано високу якість відеофайлів.
Зображення
Зображення не можуть бути дописами самостійно. Їх потрібно вбудувати в статтю чи колекцію або вкласти до відеозайвиклику як ескіз.
Підтримувані формати зображень
WebP, PNG, JPG, GIF
Примітка.: GIF-файли не можна використовувати як ескізи зображень. Використання їх в основному вмісті не рекомендується через обмежену якість.
Розмір зображення
Зображення вмісту
Рекомендовано, щоб зображення були заввишки або шириною не менше 720 пікселів. Максимальний розмір файлу зображення – 15 МБ. Зображення можуть мати будь-які пропорції, але можуть відображатися неправильно, якщо їх співвідношення менше за 0,5 або більше 1,89.
Ескізи зображень
Ескіз – це основне зображення, яке супроводжує заголовок вмісту.
-
Рекомендований розмір зображення – 1200x624px із мінімальною роздільною здатністю 72.
-
Бажані пропорції зображення – 1,91:1
-
Максимальний розмір файлу має становити 2 МБ
Соціальні мережі
MSN підтримує вбудовування з:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Процвітати
-
Карти Google
-
Giphy
-
Reddit (Реддіт)
-
TikTok (TikTok)
MsN рекомендує використовувати код вбудовування за промовчанням, наданий вихідним сайтом. Клацніть тут, щоб переглянути приклади коду вбудовування для поширених сайтів соціальних мереж.
Правила метаданих каналу
-
У видавця мають бути права на розповсюдження всього вмісту каналу. Якщо видавець не має прав синдикувати деякі зображення, він повинен встановити значення "HasSyndicationRights" значення false.
-
Усі канали мають бути свіжими та регулярно оновлюватися, перш ніж жити.
-
Настроюване зіставлення не підтримується, усі поля слід указати відповідно до наведених прикладів.
-
Кінцеві точки партнерів мають бути статичними або незмінними, якщо немає потреби створювати динамічні значення, наприклад сегменти маршруту, значення рядка запиту та значення заголовка запиту HTTP.
-
Усі елементи каналу мають бути однією мовою, настроєною для каналу.
-
Кодування UTF-8 за замовчуванням, якщо інше не вказано в XML-тегу. Канали з мішаним або кодуванням не настають.
-
Канали не мають містити неприпустимі символи, які не було вилучено, наприклад "&", "<", ">", подвійні лапки та одинарні лапки. Елементи з керівними символами не вдасться отримати.
-
Корпорація Майкрософт може позбавити будь-яких зв'язків переважно рекламного характеру.
-
Щоб сповіщати видавця про проблеми з динамічним сайтом, наприклад застарілі канали, електронні листи контактних осіб Publisher мають зберігатися, коли бренд видавця має використовуватися для сповіщення видавця вмісту про проблеми з сайтом у реальному часі.
Виявлення змін інформаційного каналу
MsN зберігає ресурси під час отримання даних, лише оброблюючи канали, які містять новий або оновлений вміст. Зміни можна позначати двома способами:
HTTP ETags
Видавці можуть надіслати запит із заголовком ETag, який діє як контрольна сума вмісту каналу. Тег буде кешовано та надіслано назад у заголовку If-None-Match під час запиту каналу.
Востаннє змінено
Вміст, надісланий із заголовком "Востаннє змінено ", буде кешовано, а наступний запит отримає заголовок If-Modified-Since . Якщо з дати останнього змінення не було внесено жодних змін, сервери інформаційних каналів відповідатимуть кодом стану 304.
Автентифікація каналу
Автентифікація каналу не обов'язкова. За потреби видавці можуть додавати вміст ні з чим іншим, як URL-адресою джерела каналу, але MSN також підтримує базову автентифікацію та OAuth 2.0. Клацніть тут, щоб переглянути діаграму з докладними відомостями про процес створення каналу.
Базова автентифікація
MSN підтримує базову автентифікацію, як зазначено в RFC 7517. Щоб додати базову автентифікацію до каналу, надайте:
-
Ім’я користувача
-
Пароль
-
URL-адреса захищеного каналу
OAuth 2.0
Щоб додати автентифікацію OAuth 2.0 до свого каналу, надайте:
-
URL-адреса сервера маркерів безпеки
-
Client_ID
-
Grant_Type
-
Область (необов'язкова), яка використовується для позначення рівня доступу. Це значення буде надіслано без змін.)
-
URL-адреса захищеного каналу
Кодування документа
MsN за замовчуванням використовує кодування UTF-8. Ви можете змінити цей параметр, змінивши атрибут кодування вузла prolog на припустиме значення кодування.
Підтримувані формати каналів
MSN підтримує RSS, ATOM і деякі підмножини media RSS, Dublin Core та інших просторів імен, описаних у медіа-RSS.
Великі канали
MSN рекомендує підтримувати розмір каналу менше 30 свіжих елементів у будь-який час, але ви можете використовувати функцію довантаження каналів ATOM, щоб увімкнути розсувне вікно для подавання вашого каналу.
Обмеження та обробка помилок
Максимальний розмір каналу – 10 МБ , а максимальний розмір зображення – 14 МБ. MsN автоматично запускає ескалацію, якщо вміст, що походить більше трьох днів. Якщо ви маєте різні вимоги до віку для вмісту, зверніться до нас за адресою PartnerHubSupport@microsoft.com. MSN повторно випробує канали з помилками, але якщо помилки не повторяться, вас буде повідомлено для дослідження. MSN автоматично вимикає вміст із каналів, які залишаються в стані помилки протягом тривалого періоду часу.
Розширення каналів із просторами імен
Ви можете розширити словник і терміни каналу в каналах на основі XML, а також рекомендовані префікси. MSN розпізнає лише елементи та атрибути, явно вказані в наведених нижче прикладах коду. Будь-які непідтримувані простори імен ігноруватимуться.
|
Ім'я розширення |
Prefix (Префікс) |
Простір імен |
|---|---|---|
|
RSS-канал мультимедіа |
мультимедіа |
http://search.yahoo.com/mrss/ |
|
Метадані Dublin Core |
постійний струм |
http://purl.org/dc/elements/1.1/ |
|
Умови Dublin Core |
постійні диски |
http://purl.org/dc/terms/ |
|
Власні служби Microsoft Ingestion |
Мі |
http://schemas.ingestion.microsoft.com/common/ |
