概述：社交聯合API

錯誤訊息

如果任何API請求失敗，將返回錯誤消息。錯誤響應如下所示：

  [
    {
      "error_code" : "Application error code 1",
      "message" : "Application error message 1"
    }, {
      "error_code" : "Application error code 2",
      "message" : "Application error message 2"
    }
  ]

建立聯合

方法：POST

端點：/accounts/{account_id}/mrss/syndications

請求主體範例：

  {
    "name": "my mp4 feed",
    "type": "mp4"
  }

請注意，name和type欄位是必要欄位。其他是可選的。

更新企業聯合組織

方法：PATCH

端點：/accounts/{account_id}/mrss/syndications/{syndication_id}

請求主體範例：

  {
    "name": "my new name"
  }

請注意，PATCH 要求的要求主體不得包含欄位 ( type、id和syndication_url )。

刪除聯合組織

方法：DELETE

端點：/accounts/{account_id}/mrss/syndications/{syndication_id}

獲取帳戶的所有企業聯合組織

方法：GET

端點：/accounts/{account_id}/mrss/syndications

獲得特定的聯合組織

方法：GET

端點：/accounts/{account_id}/mrss/syndications/{syndication_id}

設置通用聯合組織的模板

方法：PUT

端點：/accounts/{account_id}/mrss/syndications/{syndication_id}/template

請求主體範例：

  <feed header>My Feed Header</feed header>
  

上面的模板將生成類似於以下內容的供稿：

  <feed header>My Feed Header</feed header>
    <item>
      <title>Title for Video 1</title>
      <video_info>Description for Video 1</video_info>
    </item>
    <item>
      <title>Title for Video 2</title>
      <video_info>Description for Video 2</video_info>
    </item>

獲取通用聯合組織的模板

方法：GET

端點：/accounts/{account_id}/mrss/syndications/{syndication_id}/template

獲取與聯合發布相關聯的供稿

您可以從聯合發行項目的syndication_url欄位取得摘要 URL，或是手動建構。請注意，聯合動態消息 API 也可用來擷取動態消息，而無需驗證。

方法：GET

端點：/accounts/{account_id}/mrss/syndications/{syndication_id}/feed

頂級屬性

源自聯合發布字段

• album_art_url
• author
• category
• description
• destination_url
• explicit
• keywords
• name
• owner_name
• owner_email
• subtitle
• syndication_id
• syndication_url
• title

視頻雲帳戶ID

• account_id

VideoCloud默認播放器頁面網址前綴

像這樣使用：

  <media:player url="//default_default/index.html?videoId=">

• player_url

提要下一頁的URL

• next_page

從目錄中檢索到的視頻資產的集合（有關詳細信息，請參見下文）

• assets

資產屬性

資產集合中的資源來自CMS Get Videos API方法返回的視頻資源，並且支持所有相同的屬性，包括但不限於以下各項：

• created_at
• description
• duration
• id
• images
• images.thumbnail
• images.poster
• long_description
• name
• original_filename
• published_at
• schedule
• state
• tags
• text_tracks
• updated_at

資產資源還支持以下屬性：

• sources（視頻源集合-請參閱源屬性下一節）
• digital_master（如果沒有數字主機存在，則為空-請參閱下面的數字主機屬性）
• best_mp4_source（最高質量的 MP4 源-如果沒有 MP4 源，則可能為空。屬性將與中返回的項目相同sources）
• hls_source（返回 HLS 源-如果不存在，則為空）
• best_dynamic_rendition_quality (如果已擷取視訊的動態轉譯中繼資料，則傳回影格大小最大之視訊動態轉譯的視訊品質。允許的值為“ SD”，“ HD”，“ FHD”和“ UHD”。）

源屬性

資產的源集合中的資源來自CMS Get Video Sources API方法返回的視頻源資源。支援下列屬性：

• app_name
• asset_id
• codec
• container
• created_at
• duration
• encoding_rate
• height
• size
• src
• stream_name
• type
• uploaded_at
• width

數字主機屬性

資產的digital_master資源衍生自 CMS 取得數位主資訊 API 方法傳回的數位主資源。支援下列屬性：

• duration
• encoding_rate
• height
• size
• url
• width

動態再現屬性

資產的dynamic_renditions資源衍生自 CMS 取得數位主機資訊 API 方法傳回的動態轉譯。支援下列屬性：

• rendition_id
• frame_height
• frame_width
• media_type
• encoding_rate
• created_at
• updated_at
• size
• duration
• audio_configuration
• language
• variant

液體的延伸

toUTC過濾器

我們擴展了Liquid解析器以支持toUTC過濾器，該過濾器將解析大多數標準ISO-8601日期時間字符串格式並將其轉換為標準UTC日期時間字符串。Liquid的日期過濾器可以接受這種格式，然後可以使用該格式將時間戳重新格式化為任何所需格式的日期時間字符串。例如：

  <pubDate>{{asset.published_at | toUTC | date: "%a, %d %b %Y %H:%M:%S %Z"}}</pubDate>

如果asset.published_at的值為2019-08-09T13：32：52.031Z：，則會產生類似以下的輸出：

  <pubDate>Fri, 09 Aug 2019 09:32:52 +0000</pubDate>

toEpoch過濾器

我們使用的Liquid解析器在日期過濾器中不支持將日期轉換為Unix紀元時間戳的“％s”令牌。為了解決這個問題，提供了一個toEpoch定製過濾器，該過濾器可用於將有效日期規範轉換為紀元格式。過濾器返回一個數字數據值，該值表示自適合輸入數學過濾器的時期以來的毫秒數。例如：

  <toEpochMillis>{{"now" | toEpoch }}</toEpochMillis>
  <toEpochSeconds>{{"now" | toEpoch | divided_by : 1000 }}</toEpochSeconds>
  <thirtyDaysAgo>{{'now' | toEpoch | minus:2592000000 | fromEpoch }}</thirtyDaysAgo>

產生如下所示的輸出：

  <toEpochMillis>1580917253024</toEpochMillis>
  <toEpochSeconds>1580917253</toEpochSeconds>
  <thirtyDaysAgo>2020-01-06T15:40:53.055Z</thirtyDaysAgo>

fromEpoch過濾器

FromePoch 篩選器會將代表紀元以來毫秒的數字轉換為 UTC 日期字串。過濾器還將接受包含紀元值數字的字符串作為輸入。如有必要，可以將輸出傳遞到日期過濾器以重新格式化。

例如：

  
  <fromEpochMillis>{{"now" | toEpoch | fromEpoch }}</fromEpochMillis>
  <thirtyDaysAgoAltFormat>{{1580917253024 | fromEpoch | date:"%Y-%m-%d" }}</thirtyDaysAgo>
  

產生如下所示的輸出：

  
  <fromEpochMillis>2020-02-05T16:09:37.809Z</fromEpochMillis>
  <thirtyDaysAgoAltFormat>2020-02-05</thirtyDaysAgo>