FTP バッチ プロビジョニングでカスタム メタデータを設定する

Product
Video Cloud
対象となる役割
パブリッシャ, 開発者
バージョン
Brightcove 5
エディション
Pro, Enterprise

カスタム メタデータをご利用いただけるのは、Video Cloud Pro および Enterprise をご購入のお客様のみです。Video Cloud アカウントのアップグレードについては、ブライトコーブにお問い合わせください。

Video Cloud アカウントのカスタム メタデータを設定後に、動画のカスタム メタデータ フィールドに値を設定できます。Media モジュール、FTP バッチ プロビジョニング、または Media API を使用し、動画のメタデータを設定し、読み取ることができます。このトピックでは、Video Cloud の FTP バッチ プロビジョニング機能を使用し、動画にカスタム メタデータを設定する方法について説明します。概要情報については、「FTP バッチ プロビジョニング機能を使用する」を参照してください。

事前確認事項

動画に対してカスタム メタデータを設定する前に、アカウントで使用するカスタム メタデータ フィールドを設定する必要があります。「カスタム メタデータ フィールドの設定方法」を参照してください。また、バッチ プロビジョニング用の XML マニフェストを作成する方法も含め、Video Cloud の FTP バッチ プロビジョニング機能を使用する方法も理解しておく必要があります。

FTP バッチ プロビジョニング マニフェストでカスタム メタデータを設定する

動画に対してカスタム メタデータを設定するには、XML マニフェストの title 要素に、1 つ以上の任意のカスタム要素を含めます。title 要素には、任意の数のカスタム メタデータの子要素を含めることができます。

custom-string-value 要素で、文字列タイプのカスタム メタデータを設定します。name 属性を使用してカスタム メタデータ フィールドの内部名(表示名ではない)を指定し、フィールドの文字列値をタグの内容として含めます。次の例では、style というカスタム メタデータ フィールドを Martial Arts という文字列値に設定します。

<title name="Kung-Fu Web Designers"
    refid="desgowild0021"
    video-full-refid="desgowild0021.flv"
    thumbnail-refid="desgowild0021_thumb.jpg"
    video-still-refid="desgowild0021_still.jpg">
    <short-description>
Web designers, kickin' butt and takin' names.
 </short-description>
    <custom-string-value name="style">Martial Arts</custom-string-value>  
</title>

custom-enum-value 要素で、リスト(列挙)タイプのカスタム メタデータを設定します。name 属性を使用してカスタム メタデータ フィールドの内部名(表示名ではない)を指定し、フィールドの文字列値をタグの内容として含めます。次の例では、moonPhase というカスタム メタデータ フィールドを gibbous という列挙値に設定します。

<title name="Kung-Fu Web Designers"
    refid="desgowild0021"
    video-full-refid="desgowild0021.flv"
    thumbnail-refid="desgowild0021_thumb.jpg"
    video-still-refid="desgowild0021_still.jpg">
    <short-description>
When the moon goes past half full, the web designers knock heads.
 </short-description>
    <custom-enum-value name="moonPhase">gibbous</custom-enum-value>  
</title>

バッチ マニフェストのカスタム フィールドに対して無効な値を設定すると(1,024 文字より長い文字列値を設定したり、リスト定義に存在しないリスト値を設定したりするなど)、そのタイトルの更新や作成は失敗し、不正な値に関する情報を記したエラー通知メールを受信します。

列挙値は大文字と小文字を区別しないので注意してください。つまり、上記の例で「gibbous」または「Gibbous」と設定しても、タイトルは正常に更新されます。