デジタルマスター削除API

このトピックでは、CMS APIを利用してデジタルマスターを削除する方法について説明します。

概要

挽き目 CMS API には、ビデオクラウドのcatalog内のデジタルマスター(ビデオのソースファイル)を削除する機能があります。これにより、XNUMX回限りのクリーンアップタスクを実行して、管理対象コンテンツのサイズを小さくすることができます。

マスターファイルがどのようにアーカイブされるか、もしくは全くアーカイブされないようにするのかを理解するためには、以下の資料をご参照ください。アーカイブマスター.

要件

デジタルマスターの削除はCMS API のみとなります。デジタルマスターの削除はCMS APIの使用のみで可能となります。このオプションは、Studio上では利用できません。

マスターファイルを削除することによる影響

実行する前に、以下のデジタルマスターを削除することによる影響をご理解ください。

マスターを削除した後、ビデオを再トランスコードすることはできなくなります。新しいレンディションが必要な場合は、動画を以下の方法で上書きする必要があります。 Studio または Dynamic Ingest API.
バッチプロビジョニング（非推奨）によるビデオの管理はもはや機能しません。 CMS API と Dynamic Ingest を代わりにご使用ください。
デジタルマスターを削除する作業は 恒久的な ものとなります。 削除されたデジタルマスターを復元することはできません 。

手順：デジタルマスターを削除する

デジタルマスターを削除するには、以下の手順に従ってください。

必ず もし必要になった場合のことを考慮して、マスターファイルのコピーがあることを確認してください 。
動画を再変換する必要がある場合は、マスターを削除する前に再変換してください。マスターが削除された後は 動画を再トランスコードすることができなくなります。

作業に必要なクライアント情報を取得してください。クライアント情報には、以下の作業を実行する権限が含まれている必要があります。

      [
          "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);

これらのエンドポイントを使用してデジタルマスターを削除します。

マスターを削除
ベースURL	`https://cms.api.brightcove.com/v1`
方法	`DELETE`
エンドポイント	`/accounts/accountID/videos/videoID/digital_master`
レスポンス	204 NO_CONTENT（204は削除操作の標準的な応答で、操作が成功したこと、またはそのアセットがすでに削除されていることを示します）