ข้อมูลจําเพาะของเนื้อหาฟีดใน MSN Partner Hub ได้รับการออกแบบมาเพื่อตรวจสอบให้แน่ใจว่าเนื้อหาจากคู่ค้ามีการตรวจสอบความถูกต้อง และเผยแพร่อย่างมีประสิทธิภาพและแม่นยํา ข้อกําหนดเหล่านี้ครอบคลุมด้านต่างๆ ของการจัดการเนื้อหา รวมถึงชนิดเนื้อหา รูปแบบ กฎเมตาดาต้า และแนวทางในการรักษาสถานภาพและความน่าเชื่อถือของฟีดที่สนับสนุน
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 ขนาดไฟล์วิดีโอสูงสุดคือ 2GB ไฟล์ขนาดใหญ่ เช่น วิดีโอ 4K และวิดีโอที่ยาวขึ้น อาจไม่สามารถกลืนได้
หมายเหตุ: การอัปสเกลไม่ได้รับการสนับสนุน ดังนั้นจึงขอแนะนําให้ใช้คุณภาพไฟล์วิดีโอสูง
รูปภาพ
ไม่สามารถโพสต์รูปภาพด้วยตนเองได้ โดยต้องฝังลงในบทความหรือแกลเลอรีหรือแนบกับโพสต์วิดีโอเป็นรูปขนาดย่อ
รูปแบบรูปภาพที่สนับสนุน
WebP, PNG, JPG, GIF
หมายเหตุ: ไม่สามารถใช้ GIF เป็นรูปขนาดย่อได้ ไม่แนะนําให้ใช้ในเนื้อหาหลักเนื่องจากมีคุณภาพ จํากัด
ขนาดรูป
รูปภาพในเนื้อหา
ขอแนะนําให้ใช้รูปภาพที่มีความสูงหรือความกว้างอย่างน้อย 720 พิกเซล ขนาดไฟล์รูปสูงสุดคือ 15MB รูปภาพอาจเป็นอัตราส่วนกว้างยาวใดๆ แต่อาจแสดงอย่างไม่ถูกต้องหากอัตราส่วนน้อยกว่า .5 หรือมากกว่า 1.89
รูปขนาดย่อ
รูปขนาดย่อเป็นรูปภาพหลักที่มาพร้อมกับพาดหัวเนื้อหา
-
ขนาดรูปภาพที่แนะนําคือ 1200x624 พิกเซล โดยมี DPI ขั้นต่ํา 72
-
อัตราส่วนภาพที่ต้องการคือ 1.91:1
-
ขนาดไฟล์สูงสุดควรเป็น 2MB
สื่อสังคมออนไลน์
MSN สนับสนุนการฝังจาก:
-
Twitter
-
Facebook
-
Instagram
-
Pinterest
-
Infogram
-
Spotify
-
เจริญ
-
Google Maps
-
Giphy
-
Reddit
-
TikTok
MSN ขอแนะนําให้ใช้โค้ดฝังตัวเริ่มต้นที่ให้มาโดยไซต์ต้นทาง คลิกที่นี่เพื่อดูตัวอย่างของโค้ดฝังตัวสําหรับไซต์สื่อสังคมทั่วไป
กฎของตัวดึงข้อมูลเมตาดาต้า
-
Publisher ต้องมีสิทธิ์ในการแจกจ่ายเนื้อหาทั้งหมดภายในตัวดึงข้อมูล หากผู้เผยแพร่ไม่มีสิทธิ์รวบรวมรูปภาพบางรูป ผู้เผยแพร่ต้องตั้งค่า "HasSyndicationRights" เป็นเท็จ
-
ฟีดทั้งหมดจะต้องสดและอัปเดตเป็นประจําก่อนที่จะเผยแพร่
-
การแมปแบบกําหนดเองไม่ได้รับการสนับสนุน ต้องระบุเขตข้อมูลทั้งหมดตามตัวอย่างที่ระบุ
-
จุดสิ้นสุดของคู่ค้าต้องเป็นแบบคงที่/ไม่เปลี่ยนแปลงเมื่อไม่มีความต้องการในการสร้างค่าแบบไดนามิกใดๆ เช่น ส่วนเส้นทาง ค่าสตริงคิวรี และค่าส่วนหัวของคําขอ HTTP
-
รายการทั้งหมดในตัวดึงข้อมูลต้องอยู่ในภาษาเดียวกันที่กําหนดค่าสําหรับตัวดึงข้อมูล
-
การเข้ารหัสคือ UTF-8 ตามค่าเริ่มต้น เว้นแต่จะระบุไว้ในแท็ก xml ฟีดที่มีแบบผสมหรือการเข้ารหัสจะไม่สามารถป้อนเข้าได้
-
ตัวดึงข้อมูลไม่ควรมีอักขระที่ไม่ถูกต้องใดๆ ที่ไม่หลีกหนีเช่น "&", "<", ">", อัญประกาศคู่และอัญประกาศเดี่ยว รายการที่มีอักขระควบคุมจะไม่สามารถกลืนกินได้
-
Microsoft อาจตัดลิงก์ใดๆ ที่มีลักษณะเป็นการส่งเสริมการขายเป็นหลัก
-
ต้องจัดเก็บอีเมลของผู้ติดต่อ 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 ตามค่าเริ่มต้น คุณสามารถเขียนทับได้โดยการเปลี่ยนแอตทริบิวต์การเข้ารหัสของโหนดโพรล็อกเป็นค่าการเข้ารหัสที่ถูกต้อง
รูปแบบตัวดึงข้อมูลที่ได้รับการสนับสนุน
MSN รองรับ RSS, ATOM และชุดย่อยของ Media RSS, Dublin Core และ Namespace อื่นๆ ที่มีรายละเอียดใน Media RSS
เนื้อหาสรุปขนาดใหญ่
MSN ขอแนะนําให้รักษาขนาดฟีดที่มีรายการใหม่น้อยกว่า 30 รายการตลอดเวลา แต่คุณสามารถใช้คุณลักษณะ การแบ่งหน้าฟีด ของ ATOM เพื่อเปิดใช้งานการเพิ่มข้อมูลของหน้าต่างเลื่อนได้
ขีดจํากัดและการจัดการข้อผิดพลาด
ขนาดฟีดสูงสุดคือ 10MB และขนาดรูปภาพสูงสุดคือ 14MB MSN จะทริกเกอร์การเลื่อนระดับโดยอัตโนมัติถ้าเนื้อหาที่นําเข้ามีอายุมากกว่าสามวัน หากคุณมีข้อกําหนดด้านอายุของเนื้อหาที่แตกต่างกัน ติดต่อเราที่ PartnerHubSupport@microsoft.com MSN จะลองป้อนตัวดึงข้อมูลที่มีข้อผิดพลาดอีกครั้ง แต่ถ้าข้อผิดพลาดยังคงอยู่ คุณจะได้รับแจ้งให้ตรวจสอบ MSN จะปิดการเพิ่มเนื้อหาโดยอัตโนมัติจากเนื้อหาสรุปที่ยังคงอยู่ในสถานะข้อผิดพลาดเป็นระยะเวลานาน
การขยายตัวดึงข้อมูลด้วย Namespace
คุณสามารถขยายคําศัพท์และคําในเนื้อหาสรุปที่ใช้ XML พร้อมกับคํานําหน้าที่แนะนําได้ MSN จะจดจําเฉพาะองค์ประกอบและแอตทริบิวต์ที่ระบุอย่างชัดเจนใน ตัวอย่างโค้ดที่แสดงอยู่เท่านั้น Namespace ที่ไม่ได้รับการสนับสนุนใดๆ จะถูกละเว้น
|
ชื่อส่วนขยาย |
คำนำหน้า |
Namespace |
|---|---|---|
|
RSS สื่อ |
สื่อ |
http://search.yahoo.com/mrss/ |
|
เมตาดาต้าหลักดับลิน |
dc |
http://purl.org/dc/elements/1.1/ |
|
ข้อกําหนดหลักของดับลิน |
dcterms |
http://purl.org/dc/terms/ |
|
Microsoft Ingestion Services ที่เป็นกรรมสิทธิ์ |
mi |
http://schemas.ingestion.microsoft.com/common/ |
