賃貸システムの概要
CMS API には、ビデオクラウドのcatalog内のデジタルマスター(ビデオのソースファイル)を削除する機能があります。これにより、XNUMX回限りのクリーンアップタスクを実行して、管理対象コンテンツのサイズを小さくすることができます。
マスターファイルがどのようにアーカイブされるか、もしくは全くアーカイブされないようにするのかを理解するためには、以下の資料をご参照ください。 アーカイブマスター.
Requirements
- デジタルマスターの削除は、を使用して実行できます。 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
ヘッダ Authorization: Bearer Authorization: Bearer {access_token}
対応 204 NO_CONTENT(204は削除操作の標準的な応答で、操作が成功したこと、またはそのアセットがすでに削除されていることを示します)