サポート サポート問い合わせ先 | システムステータス システムステータス

デジタルマスター削除API

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

概要

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

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

要件

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

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

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

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

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

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

  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. これらのエンドポイントを使用してデジタルマスターを削除します。
    マスターを削除
    ベースURL
          https://cms.api.brightcove.com/v1
    方法 DELETE
    エンドポイント
          /accounts/accountID/videos/videoID/digital_master
    レスポンス 204 NO_CONTENT(204は削除操作の標準的な応答で、操作が成功したこと、またはそのアセットがすでに削除されていることを示します)

ページの最終更新日:12年2020月XNUMX日