概述： Social Syndication 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 字段，或手動構建。 請注意 聯合供稿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

Video Cloud 帳戶ID

• account_id

VideoCloud默認 player 頁面網址前綴

像這樣使用：

  <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 Get Digital Master Info API方法返回的數字主資源。 支持以下屬性：

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

動態再現屬性

dynamic_renditions 資產的資源是從CMS Get Digital Master Info 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></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</toEpochMillis>
  <toEpochSeconds>0</toEpochSeconds>
  <thirtyDaysAgo>-2592000000</thirtyDaysAgo>

產生如下輸出：

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

fromEpoch過濾器

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

例如：

  
  <fromEpochMillis>now</fromEpochMillis>
  <thirtyDaysAgoAltFormat>52067-04-10</thirtyDaysAgo>
  

產生如下輸出：

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