簡介
CMS API 具備刪除數字母版(視頻的源文件)中的功能 Video Cloud 目錄。 這將允許您執行一次性清理任務以減小託管內容的大小。
要了解母版的存檔方式,以及如何完全阻止母版存檔(如果要這樣做),請參閱 歸檔大師.
要求
- 可以使用 CMS API 僅由 -該選項在Studio中不可用。
刪除母版的含義
在繼續之前,請確保您了解刪除數字母版的以下含義:
- 刪除母版後,您將不再能夠重新轉碼視頻。 如果您需要新的演繹版本,則必須通過以下方式替換視頻 工作室 或者 Dynamic Ingest API.
- 通過批次設置(不建議使用)管理視頻將不再起作用。 使用 不育系 以及 動態攝取 改為使用API。
- 刪除數字主機是一個 永久 操作。 我們 不能 恢復已刪除的數字母版。
步驟:刪除數字母版
請按照以下步驟刪除數字主機。
- 確定 你有自己的主人副本 萬一您需要它。
- 如果您需要重新轉碼任何視頻,請在刪除母版之前進行。 母版刪除後 您將不再能夠重新轉換視頻。
- 獲取操作所需的客戶端憑據。 客戶端憑據必須包含以下操作的權限:
[ "video-cloud/asset/delete", "video-cloud/video/read" ]
這些權限是 不 在Studio用戶界面中可用,因此您需要使用 OAuth API 獲得它們。 下面是一個cURL命令,如果您用自己的信息替換突出顯示的項目,它將執行此工作:
curl --request POST \ --url https://oauth.brightcove.com/v4/client_credentials \ --header 'authorization: BC_TOKEN YOUR_BC_TOKEN' \ --header 'content-type: application/json' \ --data '{ "type": "credential", "maximum_scope": [ { "identity": { "type": "video-cloud-account", "account-id": YOUR_ACCOUNT_ID }, "operations": [ "video-cloud/asset/delete", "video-cloud/video/read" ] } ], "name": "Delete-Masters" }'
要獲取BC_TOKEN,請打開任何Studio頁面(您需要成為該帳戶的管理員),在瀏覽器中打開JavaScript控制台,粘貼下面的Javascript代碼,然後按回車鍵(輸入):
var cookiesArray = document.cookie.split(";"), cookiesObj = {}, i, tmpArray = []; for (i = 0; i < cookiesArray.length; i++) { tmpArray = cookiesArray[i].split("="); if (tmpArray[0].indexOf('BC_TOKEN') > -1) { cookiesObj.BC_TOKEN = tmpArray[1]; } } window.prompt("BC_TOKEN:", cookiesObj.BC_TOKEN);
- 使用客戶端憑據來 生成訪問令牌
- 使用這些端點刪除數字主機。
刪除母版 基本網址 https://cms.api.brightcove.com/v1
選項 DELETE
端點 /accounts/accountID/videos/videoID/digital_master
頭 Authorization: Bearer Authorization: Bearer {access_token}
響應 204 NO_CONTENT(204是刪除操作的標準響應,指示該操作成功,或者資產已被刪除。)