カスタムメタデータフィールドの作成

このトピックでは、動画にカスタムメタデータフィールドを追加する方法について説明します。
 

カスタムメタデータを使用すると、動画に追加のメタデータフィールドを設定できます。カスタムフィールドはアカウント設定の一部として追加されます。追加後は、Media モジュールを使用してフィールドに値を割り当てることができます。

カスタムフィールドの作成

カスタムフィールドを作成するには、以下の手順に従ってください。

  1. Video Cloud Studio にログインします。
  2. 管理者 メニューを開き、カスタムフィールド を選択します。管理者メニューへのアクセスにはアカウント管理者権限が必要です。
  3. カスタムフィールド ページには、カスタムフィールドとすべての標準動画メタデータフィールドが表示されます。新しいカスタムフィールドを作成する前に標準フィールドを確認してください。既存の標準フィールドで目的を達成できる場合、不要なカスタムフィールドの作成を避けることができます。
    Video Fields page
  4. カスタムフィールドの追加 をクリックします。
    Adding a field
  5. 表示名 を入力します。この名前は、Upload および Media モジュールでフィールドラベルとして表示されます。内部名 は表示名を基に自動的に生成されます。内部名は、Brightcove の API でプログラム的にフィールドへアクセスする際に使用されます。内部名は変更可能ですが、空白、2 バイト文字、句読点を含めることはできません。

    内部名にはスペースが含まれず、すべて小文字になります。一般的には表示名を小文字に変換し、スペースをアンダースコアに置き換えることで作成されます。

    例えば、表示名として My Field を入力すると、内部名は my_field になります。

  6. タイプ を選択します。
    • 文字列 - ユーザーが最大 1024 バイト(または 512 の 2 バイト文字)まで入力できます。
    • リスト - ユーザーは定義された値のリストから選択します。リストは最大 150 個の値を持て、それぞれ最大 100 文字まで入力可能です。
    • 日にち/時間 - 日付と時刻を 1 つのフィールドで保存・管理でき、正確なタイムスタンプが可能になります。
    • 文字バリデーションを伴う数値フィールド - 数字データに対して、電話番号や郵便番号など特定の形式での入力を求める文字検証を設定できます。
    • ブール値フィールド - true/false 形式の選択肢を使って、アクティブ/非アクティブなどの 2 値の状態をカスタムメタデータとして表現できます。
  7. 説明 を入力します。この説明は、Studio インターフェースでヒントとして表示されます。
  8. このカスタムフィールドを必須にする場合は、このフィールドを必須にする にチェックを入れます。
  9. フィールドタイプが リスト の場合、カンマ区切りの値を入力して リストに追加 をクリックします。
    Adding a field
  10. フィールドの保存 をクリックして変更を保存します。保存し、さらに追加 をクリックすると保存と次のフィールド作成が続けて行えます。

作成されたカスタムフィールドはすぐに利用可能となり、Media モジュールに表示されます。

最大で 10 個のカスタムフィールドを作成できます。10 個以上必要な場合は、Video Fields ページの さらにフィールドが必要ですか? リンクをクリックして、Brightcove カスタマーサポートに追加のリクエストを送信してください。パブリッシャーアカウントでは最大 50 個まで作成可能です。

リスト値の編集

リスト タイプのカスタムフィールドに追加の値を加えることができます。カスタムフィールド名のリンクをクリックし、値を追加してから リストに追加 をクリックします。完了したら、フィールドを保存 をクリックしてください。

リスト値の削除

リスト タイプのカスタムフィールドから既存の値を追加または削除することができます。カスタムフィールド名のリンクをクリックし、削除したい値に対応する削除アイコン () をクリックしてから、フィールドを保存 をクリックしてください。

リストの値を削除しても、その値が割り当てられていた動画には引き続きその値が残ります。ただし、その動画を編集した場合はその値がクリアされ、新しい値を選択する必要があります。

アカウントからカスタムフィールドを削除する

アカウントからカスタムフィールドを削除するには、カスタムフィールド名に対応する削除アイコン () をクリックします。

予約済み名称

カスタムフィールドの内部名として 使用してはいけない 予約語がいくつか存在します(表示名には影響しません)。よくある予約語のひとつが category です。予約語を内部名として使用すると、そのフィールドを使った検索では結果が返されなくなります。すでに予約語を使用したカスタムフィールドがある場合は、削除して別の名称に変更するか、Brightcoveサポートにご相談ください。

以下は内部カスタムフィールド名として使用してはいけない語です。

category complete created_at
creationdate custom_fields dataimport
discriminator displayname displayname_analyzed
displayname_tokenized enddate itemstate
lastmodifieddate mediaid name
playable_now playstotal playstrailingweek
published_at publisheddate publisherid
referenceid referenceid_analyzed scheduled
referenceid_analyzed schedule.ends_at schedule.starts_at
scheduled searchtext searchtext_analyzed
startdate tag tags
text state video_type

カスタムフィールドへのプログラムによるアクセス

カスタムフィールドは、Brightcove の各種 API を使用してプログラムからアクセスできます。以下の開発者向けドキュメントで詳細をご確認ください。