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

    デジタルマスター削除API

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

    賃貸システムの概要

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

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

    Requirements

    • デジタルマスターの削除は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日