Backlot /視訊雲端CMS 連接器

需求

廣告集端點

Video Cloud 沒有一個概念ad_set，但與視訊相關聯的廣告集資料會移轉至cue_points，而且ad_set_id會儲存在該自訂欄位中。名稱，讓我們能夠識別與廣告集相關聯的影片。

請參閱移轉至視訊雲端：廣告集，瞭解如何將廣告集資料對應至不同廣告來源的尖端點的詳細資訊。

下表顯示支援哪些Backlot APIad_sets作業。

廣告集端點

取消批次 API 端點	方法	支援	注意事項
v2/ad_sets	GET		Video Cloud 沒有廣告集的概念；與每個廣告集相關聯的部分資訊會作為廣告集關聯之影片的中點資料移轉-如需詳細資訊，請參閱廣告集
	POST		Video Cloud 沒有廣告集的概念，因此嘗試建立廣告集將會失敗
v2/ad_sets/{set_id}	GET		Video Cloud 沒有廣告集的概念；與每個廣告集相關聯的部分資訊會作為廣告集關聯之影片的中點資料移轉-如需詳細資訊，請參閱廣告集
	PATCH		此要求將更新相關影片的提升點資料
	DELETE		此請求將刪除相關影片的提高點資料
v2/ad_sets/{set_id}ads	POST		將中點新增至相關視訊
	DELETE		從相關視訊移除中心點

資產端點

下表顯示支援哪些Backlot APIasset作業。

請注意查詢API僅部分支持使用SQL語句提供對資產操作進行過濾的功能。where和orderby查詢是不支持的。limit查詢應該工作。

資產端點

取消批次 API 端點	方法	支援	注意事項
/v2/assets	GET		ad類型的視頻將在視頻雲端中使用標籤ooyala_my_ads youtube類型視訊不會移轉至視訊雲端 external_id正在遷移到視頻雲，但將是一個只讀字段可用於播放 API（適用於提供視頻雲內容的 Oooyala 播放器） 週期性時間限制和 IP 限制不會移轉至視訊雲端
	POST		看到使用Backlot API提取更多細節 視訊雲端擷取需要 5MB 或chunk_size以上 (最後一個區塊除外)-如果設定為較低的值，chunk_size則會傳回錯誤 由於 Video Cloud 不支援類youtube型視訊，因此嘗試建立這些類型的視訊將會傳回錯誤。ad類型的視頻可以創建為具有標籤的普通視頻ooyala_my_ads。 youtube類型視訊不會移轉至視訊雲端
/v2/assets/{asset_id}	GET		ad類型的視頻將在視頻雲端中使用標籤ooyala_my_ads youtube類型視訊不會移轉至視訊雲端
	POST		僅透過PATCH
	PATCH		只有遷移到視頻雲的屬性才能更新，請參見後台和視頻雲：視訊和播放清單欄位
	DELETE		請注意，視頻雲將不如果視頻屬於任何播放列表，則允許刪除該視頻
/v2/assets/{asset_id}/ad_set	GET		廣告集將遷移至視訊雲端作為提供點
/v2/assets/{asset_id}/closed_captions	GET		此要求將傳回 HTTP 302 回應，其位置設定為字幕內容-請注意，視訊雲端會傳回標準標準格式的 WebVTT，這是 HTML5 字幕的標準格式，而不是 DFXP。
	PUT		取代現有的 WebVTT 文字軌；請注意，您可以上傳 WebVTT 或 DFXP 字幕-DFXP 將會轉換為 WebVTT 注意：移轉至視訊雲端的 DFXP 字幕會轉換為 WebVTT 文字軌，因為這正是布萊特灣播放器所使用的內容。關於數據遷移的兩個重要說明： 如果 DFXP 中儲存多種語言字幕，則會將其分割並轉換為不同語言的多個 WebVTT 文字軌。英文文字軌道將設定為預設值。您可以在中更改默認語言工作室如果需要的話。 因為文字軌需要語言識別碼，因此如果 DFXP 檔案不包含一個，en將會指派給轉換後的 WebVTT 註解。如果這不是正確的語言，您需要在 Studio 中編輯文字軌屬性來修正它，以便隱藏式字幕選單顯示正確的語言。
	DELETE
/v2/assets/{asset_id}/drm_attributes/{drm_type}	GET		視訊雲端中的 DRM 會套用至已啟用 DRM 帳戶的所有影片，除非它們被標記為不與drm_disabled欄位一起封裝
	PATCH		視訊雲端中的 DRM 會套用至已啟用 DRM 帳戶的所有影片，除非它們被標記為不與drm_disabled欄位一起封裝
/v2/assets/{asset_id}/generated_preview_images	GET		視訊雲端不會儲存多個縮圖影像
/v2/assets/{asset_id}/labels	GET		所有labels將被遷移到tags，因此此請求將返回視頻標籤
	POST		所有labels將被移轉到tags，因此此此請求將添加一個視頻標籤。請注意，不支援直接在視訊雲端中更新標籤。
/v2/assets/{asset_id}/labels/{label_id}	PUT		這將取代視訊雲端中的標籤 (a tag )。請注意，不支援直接在視訊雲端中更新標籤。
	DELETE		這會刪除視訊雲端中的標籤 (a tag )。請注意，不支援直接在視訊雲端中更新標籤。
/v2/assets/{asset_id}/metadata	GET		metadata項目將會移轉至表單tags中meta:;:{key}:;:{value}。請注意，每個標籤的整體長度限制為 128 個單一位元組字元。
	PUT		metadata項目將被移轉到表單tags中meta:;:{key}:;:{value} -此請求將以該格式添加或替換標籤。請注意，每個標籤的整體長度限制為 128 個單一位元組字元。
	PATCH		metadata項目將被移轉到表單tags中meta:;:{key}:;:{value} -此請求將修改該格式的標籤
	DELETE		metadata項目將被移轉到表單tags中meta:;:{key}:;:{value} -此請求將刪除所有以該格式的標籤
/v2/assets/{asset_id}/movie_urls	GET		movie_urlssources位於視訊雲端
	POST		在視頻雲中以相同的方式工作-這個請求將添加一個遠程rendition（因此source）到視頻
/v2/assets/{asset_id}/movie_urls/{type}	DELETE		此請求僅刪除指定類型的遠程轉譯
/v2/assets/{asset_id}/player	GET		此請求將返回默認的 Oooyala 播放器構造，因為視頻雲不會將播放器與視頻相關聯; 相反，任何視頻都可以通過其視頻與任何播放器實例相關聯id。您可以透過播放程式管理 API 取得視訊雲端播放器
/v2/assets/{asset_id}/player/{player_id}	GET		Video Cloud 不會將播放器與視訊產生關聯；而是，任何視訊都可以透過其視訊與任何播放程式實體建立關聯id。您可以透過播放程式管理 API 取得視訊雲端播放器
/v2/assets/{asset_id}/preview_image_urls	GET		Video Cloud 不會儲存多個縮圖影像，因此此此請求會傳回影poster像
	POST		Video Cloud 不會儲存多個縮圖影像，因此此此請求會使用清單中的第一個影像來設定影像poster
	PUT		Video Cloud 不會儲存多個縮圖影像，因此此此請求會使用清單中的第一個影像來設定影像poster
	DELETE		Video Cloud 只會儲存單一海報影像，您可以取代，但無法刪除
/v2/assets/{asset_id}/preview_image_files/{image_id}	DELETE		Video Cloud 只會儲存單一海報影像，您可以取代，但無法刪除
/v2/assets/{asset_id}/preview_image_files	GET		Video Cloud 不會儲存多個縮圖影像，因此此此請求會傳回poster影像 URL
	POST		Video Cloud 不會儲存多個縮圖poster影像，因此此此請求將使用清單中的第一個影像 URL 設定為遠端資產
	PUT		Video Cloud 不會儲存多個縮圖poster影像，因此此此請求將使用清單中清單 URL 中的第一個影像設定為遠端資產
	DELETE		Video Cloud 只會儲存單一海報影像，您可以取代，但無法刪除
/v2/assets/{asset_id}/primary_preview_image	GET		Video Cloud 只存儲一個海報圖像，因此此此請求將返回
/v2/assets/{asset_id}/primary_preview_image	PUT		Video Cloud 只會儲存一張海報影像，因此此此請求將取代海報
/v2/assets/{asset_id}/publishing_rule	GET		只會傳回地理限制和排程，因為 Video Cloud 會在播放器上設定其他播放限制，而非影片
/v2/assets/{asset_id}/publishing_rule/{rule_id}	PUT		視訊雲端沒有發佈規則的概念。只有視訊的地理限制和排程內容才能更新。發佈規則識別碼將儲存在名稱為publishing_rule_id
/v2/assets/{asset_id}/source_file_info	GET
/v2/assets/{asset_id}/streams	GET		將返回視訊雲端sources
/v2/assets/{asset_id}/uploading_urls	GET		透過Backlot API和擷取介面卡支援
/v2/assets/{asset_id}/upload_status	PUT		透過Backlot API和擷取介面卡支援
/v2/assets/{asset_id}/youtube	GET		視訊雲端不支援-請參閱 Brightcove 社交視訊雲端替代方案
	PUT		視訊雲端不支援-請參閱 Brightcove 社交視訊雲端替代方案
	PATCH		視訊雲端不支援-請參閱 Brightcove 社交視訊雲端替代方案
/v2/assets/{asset_id}/lineup	GET
	PUT
/v2/assets/lineup/{asset_id}	PUT
	DELETE
/v2/assets/{asset_id}/closed_captions	GET		將返回視頻text_track的默認值。移轉的視訊將只有一個text_track -可以透過視訊雲端新增其他影片。如果您新增更多文字軌道，請將預設的軌道設定為傳回此請求。 注意：移轉至視訊雲端的 DFXP 字幕會轉換為 WebVTT 文字軌，因為這正是布萊特灣播放器所使用的內容。關於數據遷移的兩個重要說明： 如果 DFXP 中儲存多種語言註解，則只有英文字幕會儲存在 WebVTT 文字軌中，因為 WebVTT 不支援單一檔案中的多種語言註解。如果您想要建立其他語言的字幕，您需要將字幕分割成個別的 DFXP 檔案，並使用 Studio 擷取這些字幕。 因為文字軌需要語言識別碼，因此如果 DFXP 檔案不包含一個，en將會指派給轉換後的 WebVTT 註解。如果這不是正確的語言，您需要在 Studio 中編輯文字軌屬性來修正它，以便隱藏式字幕選單顯示正確的語言。
	PUT		將取代視頻text_track的默認值-內嵌字幕可以是 WebVTT 或 DFXP 格式; DFXP 將轉換為 WebVTT
	DELETE		將刪除視頻text_track的默認值

DRM 政策

不支援 DRM 政策端點。

刪除資產端點

不支援「已刪除的資產」端點。

標示端點

標籤將會移轉至視訊雲端tags。與標籤不同，標籤是在個別影片上設定的-沒有帳戶層級的「標籤集」，標籤不是階層式的。標籤階層會保留在 Video Cloud 標籤中，如下所示：

除了這些差異之外，標籤可以用於許多標籤的方式，例如：

• 搜尋含有某些標籤、全部或沒有一組標籤的影片
• 在執行階段選取「智慧型」播放清單的影片

下表顯示支援的Backlot APIlabels端點。

取消批次 API 標籤端點

取消批次 API 端點	方法	支援	注意事項
/v2/labels	GET		標籤會顯示為tags視訊雲端
/v2/labels	POST		標籤會顯示為tags視訊雲端
/v2/labels/by_full_path/{paths}	GET		標籤會顯示為tags視訊雲端
/v2/labels/by_full_path/{paths}	POST		標籤會顯示為tags視訊雲端
/v2/labels/{label_id}	GET		標籤會顯示為tags視訊雲端
/v2/labels/{label_id}	PATCH		標籤會顯示為tags視訊雲端
/v2/labels/{label_id}	DELETE		標籤將顯示為tags在視頻雲中。請注意，如果標籤被播放清單引用，則不會刪除該標籤。
/v2/labels/{label_id}/children	GET		標籤會顯示為tags視訊雲端
/v2/labels/{label_id}/assets	GET		標籤會顯示為tags視訊雲端

套件端點

不支援套件端點。

玩家端點

下表顯示支援哪些Backlot APIplayers作業。

停用 API 播放器端點

取消批次 API 端點	方法	支援	注意事項
/v2/players	GET
	POST
/v2/players/{player_id}	GET
	PATCH
	DELETE
/v2/players/{player_id}/metadata	GET
	PATCH
	PUT
	DELETE
/v2/players/{player_id}/scrubber_image	PUT
/v2/players/{player_id}/watermark	PUT
/v2/players/{player_id}/third_party_modules/{module_id}	GET
	PUT
	PATCH
	DELETE

播放清單端點

下表顯示支援哪些Backlot APIplaylists作業。另見播放清單欄位以便更好地了解Ooyala和視頻雲播放列表之間的差異。

停用 API 播放清單端點

取消批次 API 端點	方法	支援	注意事項
/v2/playlists	GET
	POST
/v2/playlists/{playlist_id}	GET
	PUT
	PATCH
	DELETE

處理設定檔端點

下表顯示不支援哪些Backlot APIplaylists作業。另請參閱內嵌描述檔 API 管理內嵌設定檔，以更好地了解視訊雲端內嵌設定檔的運作方式-您的帳戶是動態傳遞帳戶，因此您不需要注意傳統內嵌系統的文件。

供應商層級 DRM 政策端點

不支援供應商層級 DRM 政策端點。

提供者端點

不支援提供者端點。

發佈規則端點

透過發佈規則實作的播放限制會套用至 Video Cloud 中的個別資產。網域限制不會移轉，因為在 Video Cloud 中，這些限制是在播放器上設定的，而不是視訊。

在視訊資產上

• 地理限制
• 排程（開始和結束日期時間）

與地理限制和排程相關的 Oooyala 發佈規則屬性將套用至與發佈規則相關聯的視訊，並id將儲存在具有名稱的自訂欄位中publishing_rule_id。Backlot API發行規則作業將適用於與發佈規則相關聯的所有視訊，但只會傳回排程或地理限制。

取消批次 API 處理設定檔端點

取消批次 API 端點	方法	支援	注意事項
/v2/processing_profiles	GET
/v2/processing_profiles/{profile_id}	GET

經銷商端點

不支援經銷商端點。

統計資料端點

不支援統計資料端點。

聯合發行端點

不支援聯合發行端點。然而，布萊特灣全球服務可以建立聯合發行服務，以配合您的 Oooyala 的服務。如需詳細資訊，請聯絡您的客戶經理

協力廠商模組端點

不支援統計資料端點。