サポート問い合わせ先| システムステータス
ページコンテンツ

    多言語メタデータ

    このトピックでは、さまざまな言語を話す視聴者向けに、動画に多言語メタデータを追加する方法の概要を説明します。多言語メタデータは、ブライトコーブビーコン顧客ですが、一般的にVideoCloudビデオで使用できます。

    入門

    国際的なオーディエンス(または同じ国内に多言語)がいる場合は、タイトルや説明などの動画メタデータを複数の言語で提供することができます。

    Video Cloud では、次の多言語バージョンを使用できます。

    • images
    • テキストトラック
    • 名前 (経由variants )
    • 説明variants )
    • 長い説明variants )
    • カスタムフィールド値variants )

    バリアントの作成

    を使用してCMS API((ビデオバリアントを作成する)の配列を追加および管理できますvariants代替手段を提供するnamedescriptionlong_description、および言語に固有のカスタムフィールド/値のマップ。

    バリアントを作成するには、POSTエンドポイントへのリクエスト:

    https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/
    {
      "language": "ja-JA",
      "name": "バーゼル:ライン川",
      "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
      "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
      "custom_fields": {
        "language": "Japanese"
      }
    }

    レスポンスの例

    {
      "language": "ja-JA",
      "name": "バーゼル:ライン川",
      "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
      "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
      "custom_fields": {
        "language": "Japanese"
      }
    }

    バリアントの取得

    すべてのバリアントを取得

    を送信することで、ビデオのすべてのバリエーションを取得できますGETエンドポイントへのリクエスト:

    https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants

    レスポンスの例

    [
      {
        "language": "es-ES",
        "name": "Basilea: el Rin",
        "description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
        "long_description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
        "custom_fields": {
        }
      },
      {
        "language": "de-DE",
        "name": "Basel: Der Rhein",
        "description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
        "long_description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
        "custom_fields": {
        }
      },
      {
        "language": "ja-JA",
        "name": "バーゼル:ライン川",
        "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
        "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
        "custom_fields": {
          "language": "Japanese"
        }
      }
      ]

    特定のバリアントを取得する

    特定のバリアントを取得するには、GETエンドポイントへのリクエスト:

    https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/{language}

    ここlanguageバリアントで使用される言語コードです。 de-DE

    レスポンスの例

    {
      "language": "de-DE",
      "name": "Basel: Der Rhein",
      "description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
      "long_description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
      "custom_fields": {
      }
    }

    バリアントの更新

    バリアントを更新するには、PATCHエンドポイントへのリクエスト:

    https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/{language}

    ここlanguageバリアントで使用される言語コードです。 de-DE

    変更するフィールドのみを含める必要があります。リクエストの本文フィールドは、バリアントを作成する場合と同じですが、してもいいです not 含めるlanguage分野。(含める場合language field a VALIDATION_ERROR返却されます。)

    リクエスト本文の例

    {
      "name": "Basilea: el Rin",
      "description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
      "long_description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
      "custom_fields": {
        "language": "Spanish"
     }
    }

    レスポンスの例

    {
      "language": "es-ES",
      "name": "Basilea: el Rin",
      "description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
      "long_description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
      "custom_fields": {
        "language": "Spanish"
      }
    }

    バリアントを削除する

    バリアントを削除するには、DELETEエンドポイントへのリクエスト:

    https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/{language}

    リクエスト本文は含めないでください。削除が成功すると、204 No Content応答。

    バリアントは、PlaybackAPIとCMS APIを使用して取得できます。Playback APIでは、動画を取得するとトップレベルとして返されますvariants配列:

    "variants": [
      {
        "language": "de-DE",
        "name": "Basel: Der Rhein",
        "description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
        "long_description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
        "custom_fields": {}
      },
      {
        "language": "ja-JA",
        "name": "バーゼル:ライン川",
        "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
        "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
        "custom_fields": {
          "language": "Japanese"
        }
      }
    ]

    画像とテキストトラック

    Dynamic Ingest API を使用して、代替言語の画像とテキストトラックを追加できます。詳細については、次のトピックを参照してください。


    ページの最終更新日22 Sep 2021