Thông số kỹ thuật về nội dung nguồn cấp dữ liệu trong Hub Đối tác của MSN được thiết kế để đảm bảo nội dung từ các đối tác được nhập, xác thực và phát hành hiệu quả và chính xác. Những đặc tả này bao gồm các khía cạnh khác nhau của quản lý nội dung, bao gồm các loại nội dung, định dạng, quy tắc siêu dữ liệu và hướng dẫn được hỗ trợ để duy trì trạng thái và độ tin cậy của nguồn cấp dữ liệu.
MSN hỗ trợ:
-
Bài viết, Bộ sưu tập và Video
-
Nguồn cấp HTTPS. Chúng tôi khuyên bạn nên sử dụng TLS/SSL.
MSN không hỗ trợ:
-
Liên kết chứa tên người dùng hoặc mật khẩu trong tài nguyên hoặc tham số
-
Danh sách trắng IP
-
IP tĩnh
Trong bài viết này
Phương tiện truyền thông xã hội
Quy tắc siêu dữ liệu nguồn cấp dữ liệu
Bài viết
Bài viết là các bài đăng bao gồm văn bản, hình ảnh và video. Không bắt buộc phải có hình ảnh mà chỉ có bài viết bao gồm hình ảnh mới có thể tự động phát hành.
Phòng trưng bày
Bộ sưu tập là trình chiếu bao gồm hình ảnh và chú thích. Bộ sưu tập phải có ảnh nhúng để phát hành.
Video
Bạn có thể đăng video riêng hoặc đưa vào các bài viết. Bài đăng video được đăng từ nguồn cấp dữ liệu của bạn sẽ được lưu trữ lại trên MSN, trong khi video được lưu trữ trên một trang web của bên thứ ba như YouTube hoặc DailyMotion sẽ được nhúng thông qua lưu trữ của site đó.
Video được lưu trữ trên MSN sẽ tạo ra nhiều bitrates để chuyển đổi nhiều thiết bị và phát trực tuyến thích ứng.
Các định dạng bộ chứa video được hỗ trợ
AVI, MPEG, MP4, WMV, M4V
Codec video được hỗ trợ
H.264, MPEG-1, MPEG-2, MPEG-4 v2, VC1, WMV, DV (DVC, DVHD, DVSD, DVSL)
Định dạng âm thanh được hỗ trợ
AC-3 (Dolby Digital), AAC, MP3, Windows Media Audio
Các giao thức được hỗ trợ
HTTP, FTP
Đuôi tệp được hỗ trợ
.mp4, .mpeg, .mpg, .wmv, .avi, .m4v
Kích cỡ video
Video được khuyến nghị có độ phân giải tối thiểu là 720p, 3Mbps. Kích thước tệp video tối đa là 2GB. Có thể không nhập được các tệp lớn, chẳng hạn như video 4K và video dài hơn.
Lưu ý: Không hỗ trợ tăng cấp, vì vậy chất lượng tệp video cao được khuyến nghị.
Hình ảnh
Hình ảnh không thể được đăng riêng. Chúng phải được nhúng vào bài viết hoặc bộ sưu tập hoặc đính kèm vào bài đăng video dưới dạng hình thu nhỏ.
Định dạng ảnh được hỗ trợ
WebP, PNG, JPG, GIF
Lưu ý: Không thể sử dụng gif làm hình thu nhỏ. Việc sử dụng chúng trong nội dung chính không được khuyến khích do chất lượng hạn chế.
Kích cỡ hình ảnh
Hình ảnh nội dung
Chúng tôi khuyên bạn nên để hình ảnh có chiều cao hoặc chiều rộng tối thiểu là 720px. Kích thước tệp hình ảnh tối đa là 15 MB. Hình ảnh có thể là bất kỳ tỷ lệ khung ảnh nào nhưng có thể không hiển thị chính xác nếu tỷ lệ nhỏ hơn 0,5 hoặc lớn hơn 1,89.
Hình thu nhỏ
Hình thu nhỏ là hình ảnh chính đi kèm với tiêu đề nội dung.
-
Kích thước hình ảnh được đề xuất là 1200x624px, với DPI tối thiểu là 72.
-
Tỷ lệ khung ảnh mong muốn là 1,91:1
-
Kích thước tệp tối đa phải là 2MB
Phương tiện truyền thông xã hội
MSN hỗ trợ nhúng từ:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
Phát triển
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN khuyên bạn nên sử dụng mã nhúng mặc định do trang web nguồn cung cấp. Bấm vào đâyđể xem ví dụ về mã nhúng cho các trang web truyền thông xã hội phổ biến.
Quy tắc siêu dữ liệu nguồn cấp dữ liệu
-
Publisher phải có quyền phân phối cho tất cả nội dung trong nguồn cấp. Nếu nhà xuất bản không có quyền cung cấp một số hình ảnh, họ PHẢI đặt "HasSyndicationRights" là sai.
-
Tất cả nguồn cấp dữ liệu phải mới và cập nhật thường xuyên trước khi phát trực tuyến.
-
Ánh xạ tùy chỉnh không được hỗ trợ, tất cả các trường phải được chỉ định theo ví dụ đã cho.
-
Điểm cuối của đối tác phải tĩnh/không thay đổi khi không có yêu cầu để xây dựng bất kỳ giá trị động nào chẳng hạn như phân đoạn định tuyến, giá trị chuỗi truy vấn và giá trị tiêu đề yêu cầu HTTP.
-
Tất cả các mục trong nguồn cấp phải ở cùng một ngôn ngữ được cấu hình cho nguồn cấp.
-
Mã hóa là UTF-8 theo mặc định trừ khi có quy định khác trong thẻ xml. Nguồn cấp dữ liệu có hỗn hợp hoặc mã hóa sẽ không ăn được.
-
Nguồn cấp dữ liệu không được chứa bất kỳ ký tự không hợp lệ không được thoát chẳng hạn như "&", "<", ">", dấu ngoặc kép và dấu nháy đơn. Các mục có ký tự điều khiển sẽ không thể nhập.
-
Microsoft có thể dải bất kỳ liên kết nào có bản chất quảng cáo chủ yếu.
-
Email của người liên hệ nhà xuất bản phải được lưu trữ khi thương hiệu của nhà xuất bản được lên kế hoạch sử dụng để thông báo cho nhà xuất bản nội dung về các sự cố site trực tiếp như nguồn cấp dữ liệu cũ.
Phát hiện thay đổi nguồn cấp dữ liệu
MSN tiết kiệm tài nguyên trong quá trình nhập bằng cách chỉ xử lý nguồn cấp có nội dung mới hoặc cập nhật. Các thay đổi có thể được gắn cờ theo hai cách:
HTTP ETags
Nhà xuất bản có thể gửi yêu cầu có tiêu đề ETag, hoạt động như kiểm tra nội dung nguồn cấp. Thẻ sẽ được lưu vào bộ đệm ẩn và được gửi lại về tiêu đề If-None-Match trong khi yêu cầu nguồn cấp.
Sửa đổi lần cuối
Nội dung được gửi kèm theo tiêu đề Sửa đổi Lần cuối sẽ được lưu vào bộ đệm ẩn, với yêu cầu tiếp theo nhận được tiêu đề If-Modified-Since . Máy chủ nguồn cấp dữ liệu sẽ phản hồi với mã trạng thái 304 nếu không có thay đổi nào được thực hiện kể từ ngày sửa đổi gần nhất.
Xác thực nguồn cấp dữ liệu
Không bắt buộc phải xác thực nguồn cấp dữ liệu. Nhà xuất bản có thể nhập nội dung không có gì ngoài URL nguồn cấp dữ liệu nếu họ muốn, nhưng MSN cũng hỗ trợ Xác thực cơ bản và OAuth 2.0. Bấm vào đây để xem biểu đồ trình bày chi tiết quy trình nhập nguồn cấp dữ liệu.
Xác thực Cơ bản
MSN hỗ trợ xác thực cơ bản như được chỉ định trong RFC 7517. Để thêm xác thực cơ bản vào nguồn cấp dữ liệu của bạn, hãy cung cấp:
-
Tên người dùng
-
Mật khẩu
-
URL Nguồn cấp bảo mật
OAuth 2.0
Để thêm xác thực OAuth 2.0 vào nguồn cấp dữ liệu của bạn, hãy cung cấp:
-
URL Máy chủ Mã thông báo Bảo mật
-
Client_ID
-
Grant_Type
-
Phạm vi (Tùy chọn, được dùng để chỉ báo mức truy nhập. Giá trị này sẽ được gửi như hiện tại.)
-
URL Nguồn cấp bảo mật
Mã hóa tài liệu
MSN sử dụng mã hóa UTF-8 theo mặc định. Bạn có thể ghi đè lên thuộc tính này bằng cách thay đổi thuộc tính mã hóa của nút prolog thành giá trị mã hóa hợp lệ.
Định dạng nguồn cấp được hỗ trợ
MSN hỗ trợ RSS, ATOM và một số tập con của Media RSS, Dublin Core và các không gian tên khác được nêu chi tiết trong Media RSS.
Nguồn cấp dữ liệu lớn
MSN khuyên bạn nên duy trì kích thước nguồn cấp dữ liệu dưới 30 mặt hàng mới tại mọi thời điểm, nhưng bạn có thể sử dụng tính năng phân trang Nguồn cấp dữ liệu của ATOM để bật chức năng nhập cửa sổ trượt của nguồn cấp dữ liệu.
Giới hạn và xử lý lỗi
Kích thước nguồn cấp dữ liệu tối đa là 10 MB và kích thước hình ảnh tối đa là 14 MB. MSN tự động kích hoạt báo cáo nếu nội dung được nhập cách đây hơn ba ngày. Nếu bạn có các yêu cầu về độ tuổi nội dung khác, hãy liên hệ với chúng tôi PartnerHubSupport@microsoft.com. MSN thử lại nguồn cấp có lỗi, nhưng nếu lỗi vẫn tiếp diễn, bạn sẽ được thông báo để điều tra. MSN tự động tắt tính năng nhập nội dung từ nguồn cấp dữ liệu còn ở trạng thái lỗi trong một khoảng thời gian dài.
Mở rộng nguồn cấp với không gian tên
Bạn có thể mở rộng từ vựng và thuật ngữ nguồn cấp trong nguồn cấp dựa trên XML cùng với tiền tố được đề xuất của chúng. MSN chỉ nhận dạng các phần tử và thuộc tính được chỉ định rõ ràng trong các ví dụ về mã được liệt kê. Mọi không gian tên không được hỗ trợ sẽ bị bỏ qua.
|
Tên Phần mở rộng |
Tiền tố |
Namespace |
|---|---|---|
|
Media RSS |
media |
http://search.yahoo.com/mrss/ |
|
Siêu dữ liệu Lõi Dublin |
Dc |
http://purl.org/dc/elements/1.1/ |
|
Điều khoản Cốt lõi của Dublin |
số từ |
http://purl.org/dc/terms/ |
|
Dịch vụ Nhập độc quyền của Microsoft |
Mi |
http://schemas.ingestion.microsoft.com/common/ |
