數位主版刪除 API

本主題說明如何使用 CMS API 刪除影片的數位主版。

簡介

CMS API具有刪除“視頻雲”目錄中的數字母版(視頻的源文件)的功能。這將允許您執行一次性清理任務以減小託管內容的大小。

要了解母版的存檔方式,以及如何完全阻止母版存檔(如果要這樣做),請參閱歸檔大師

需求

  • 可以使用CMS API只要 -該選項在Studio中不可用。

刪除母版的含義

在繼續之前,請確保您了解刪除數字母版的以下含義:

  • 刪除母版後,您將無法再對其進行轉碼。如果您需要新的演繹版本,則必須通過以下方式替換視頻工作室或者動態提取API
  • 通過批次設置(不推薦使用)管理視頻將不再起作用。使用不育系動態攝取改為使用API。
  • 刪除數字主機是一個常駐操作。我們不能恢復已刪除的數字母版。

步驟:刪除數字母版

請按照以下步驟刪除數字主機。

  1. 確定你有自己的主人副本萬一您需要它。
  2. 如果您需要重新轉碼任何視頻,請在刪除母版之前進行。母版刪除後您將不再能夠重新轉換視頻。
  3. 獲取操作所需的客戶端憑據。客戶端憑據必須包含以下操作的權限:
          [
              "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);
  4. 使用客戶端憑據來生成訪問令牌
  5. 使用這些端點刪除數字主機。
    刪除母版
    基本網址
          https://cms.api.brightcove.com/v1
    方法 DELETE
    端點
          /accounts/accountID/videos/videoID/digital_master
    標頭
          Authorization: Bearer Authorization: Bearer {access_token}
    響應 204 NO_CONTENT(204是刪除操作的標準響應,指示該操作成功,或者資產已被刪除。)