Спецификации содержимого веб-канала в Центре партнеров 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, 3 Мбит/с. Максимальный размер видеофайла составляет 2 ГБ. Большие файлы, такие как видео размером 4K и более длинные видео, могут не приниматься.
Примечание: Масштабирование не поддерживается, поэтому рекомендуется высокое качество видеофайла.
Изображения
Изображения не могут быть публикациями самостоятельно. Они должны быть внедрены в статью или коллекцию или прикреплены к видеосвязи в виде эскиза.
Поддерживаемые форматы изображений
WebP, PNG, JPG, GIF
Примечание: GIF-файлы не могут использоваться в качестве эскизов изображений. Их использование в содержимом main не рекомендуется из-за ограниченного качества.
Размер изображения
Изображения из содержимого
Рекомендуется, чтобы изображения были высотой или шириной не менее 720 пикселей. Максимальный размер файла изображения — 15 МБ. Изображения могут иметь любые пропорции, но могут отображаться неправильно, если отношение меньше 0,5 или больше 1,89.
Миниатюр
Эскиз — это main изображение, которое сопровождает заголовок содержимого.
-
Рекомендуемый размер изображения — 1200x624 пикселей с минимальным разрешением на дюйм 72.
-
Требуемое пропорции изображения — 1,91:1
-
Максимальный размер файла должен быть 2 МБ.
Социальные сети
MSN поддерживает внедрение из:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram;
-
Spotify
-
Процветать
-
Google Карты;
-
Giphy
-
Reddit
-
TikTok
MSN рекомендует использовать код внедрения по умолчанию, предоставляемый исходным сайтом. Щелкните здесь, чтобы просмотреть примеры кода внедрения для распространенных сайтов социальных сетей.
Правила метаданных веб-канала
-
Издатель должен иметь права на распространение для всего содержимого в веб-канале. Если у издателя нет прав на синдикацию некоторых изображений, он должен задать для HasSyndicationRights значение false.
-
Все каналы должны быть свежими и регулярно обновляться, прежде чем начать жить.
-
Пользовательское сопоставление не поддерживается, все поля должны быть указаны в соответствии с приведенными примерами.
-
Конечные точки партнеров должны быть статическими или неизменными, если не требуется создавать динамические значения, такие как сегменты маршрутов, значения строк запроса и значения заголовков HTTP-запроса.
-
Все элементы в веб-канале должны быть на одном языке, настроенном для веб-канала.
-
По умолчанию кодируется UTF-8, если в xml-теге не указано иное. Веб-каналы со смешанным или кодировкой не будут приниматься.
-
Веб-каналы не должны содержать неисправные символы, такие как "&", "<", ">", двойные кавычки и одинарные кавычки. Элементы с символами управления не будут приниматься.
-
Корпорация Майкрософт может удалить любые ссылки преимущественно рекламного характера.
-
Сообщения электронной почты контактных лиц издателя должны храниться, когда торговая марка издателя используется для уведомления издателя контента о проблемах с динамическими сайтами, таких как устаревшие каналы.
Обнаружение изменений канала
MSN экономит ресурсы во время приема, обрабатывая только веб-каналы с новым или обновленным содержимым. Изменения можно пометить двумя способами:
HTTP ETags
Издатели могут отправить запрос с заголовком ETag, который действует как контрольная сумма для содержимого веб-канала. Тег будет кэширован и отправлен обратно в заголовок If-None-Match при запросе веб-канала .
Последнее изменение
Содержимое, отправляемое с заголовком Last-Modified , будет кэшировано, а последующий запрос получает заголовок 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. Это можно переопределить, изменив атрибут кодирования узла пролога на допустимое значение кодирования.
Поддерживаемые форматы веб-каналов
MSN поддерживает RSS, ATOM и некоторые подмножества MEDIA RSS, Dublin Core и другие пространства имен, описанные в разделе Media 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/ |
|
Основные термины Дублина |
dcterms |
http://purl.org/dc/terms/ |
|
Собственные службы приема Майкрософт |
ми |
http://schemas.ingestion.microsoft.com/common/ |
