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。 視訊檔案大小上限為 2GB。 大型檔案,例如 4K 影片和較長的影片,可能會無法拵取。

附註: 不支援縮放比例,因此建議使用高視訊檔案品質。

圖像

影像無法自行張貼。 它們必須內嵌在文章或圖庫中,或附加至視訊文章做為縮圖。

支援的圖像格式

WebP、PNG、JPG、GIF

附註: GIF 無法做為縮圖影像使用。 由於品質有限,不建議在主要內容中使用。

影像大小

內容內影像

建議影像的高度或寬度至少為720px。 圖像檔大小上限為 15 MB。 影像可以是任何長寬比,但如果比例小於 .5 或大於 1.89,可能無法正確顯示。

縮圖影像

縮圖圖像是包含內容標題的主要影像。 

  • 建議的影像大小為 1200x624px,最低 DPI 為 72。

  • 所要的影像長寬比為 1.91:1

  • 檔案大小上限應該是 2MB

社交媒體

MSN 支援內嵌來源:

  • Twitter

  • Facebook

  • Instagram

  • Pinterest

  • Infogram

  • Spotify

  • 蓬勃發展

  • Google 地圖

  • Giphy

  • Reddit

  • 提克托克

MSN 建議使用來源網站提供的預設內嵌程序代碼。 按兩下 這裡以查看常見社交媒體網站的內嵌程式代碼範例。

摘要元數據規則

  • Publisher 必須擁有摘要中所有內容的發行許可權。 如果發行者沒有將某些影像聯合的許可權,則必須將 「HasSyndicationRights」 設為 False。

  • 所有摘要在上線之前都必須保持最新和定期更新。

  • 不支援自定義對應,所有欄位都必須根據指定的範例指定。

  • 合作夥伴端點必須是靜態/取消變更,不需要建立任何動態值,例如路由區段、查詢字串值和 HTTP 要求標頭值。

  • 摘要中的所有項目都必須使用摘要所設定的相同單一語言。

  • 除非在 xml 標籤中另有指定,否則編碼預設為 UTF-8。 混合或編碼的摘要將無法摱取。

  • 摘要不應包含任何未逸出的不合法字元,例如“&”、“<”、“>”、雙引號和單引號。 具有控件字元的專案將無法拵入。

  • Microsoft可能會去除主要促銷性質的任何連結。

  • 發行者的聯繫人電子郵件必須儲存在發行者的品牌上線時,才能用來通知內容發行者即時網站的問題,例如過時的摘要。

摘要變更偵測

MSN 只會處理具有新內容或更新內容的摘要,在擷取期間儲存資源。 變更可以用兩種方式標幟:

HTTP ETag

發行者可以使用 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

  • 範圍 (選擇性,用來表示存取層級。 此值會以 is.) 的形式傳送

  • 安全摘要 URL

檔編碼

MSN 預設會使用UTF-8編碼。 您可以將 prolog 節點的編碼屬性變更為有效的編碼值,藉此覆寫此設定。

支援的摘要格式

MSN 支援 RSS、ATOM,以及媒體 RSS、Dublin Core 及其他 Media RSS 中詳述的命名空間子集。

大型摘要

MSN 建議您隨時維持小於 30 個新專案的摘要大小,但您可以使用 ATOM 的摘 要頁面 功能來啟用卷動視窗摱取摘要。

限制與錯誤處理

摘要大小上限為 10 MB ,影像大小上限為 14MB。 如果報取的內容超過三天,MSN 會自動觸發升級。 如果您有不同的內容年齡需求,請 PartnerHubSupport@microsoft.com 連絡我們。 MSN 會重新嘗試有錯誤的摘要,但如果錯誤仍然存在,您會收到調查通知。 MSN 會自動關閉摘要中的內容损取功能,這些摘要會長時間維持在錯誤狀態。

使用命名空間延伸摘要

您可以在 XML 型摘要中延伸摘要詞彙及其建議的前置詞。 MSN 只會辨識所列 程式代碼範例中明確指定的元素和屬性。 任何不支援的命名空間都會被忽略。

擴充功能名稱

前置字元

命名空間

媒體 RSS

媒體

http://search.yahoo.com/mrss/

Dublin Core 元數據

直流

http://purl.org/dc/elements/1.1/

都柏林核心版條款

dcterms

http://purl.org/dc/terms/

Ingestion Services Microsoft專屬

http://schemas.ingestion.microsoft.com/common/

需要更多協助嗎?

想要其他選項嗎?

探索訂閱權益、瀏覽訓練課程、瞭解如何保護您的裝置等等。