賃貸システムの概要
あなたが国際的なものを持っているなら audience (または同じ国内の多言語)、タイトルや説明などのビデオメタデータを複数の言語で提供することをお勧めします。
Video Cloud 次の多言語バージョンを許可します。
- 画像
- テキストトラック
- 名前(経由
variants
) - 説明
variants
) - 長い説明
variants
) - カスタムフィールド値
variants
)
バリアントの作成
使い方 CMS API (ビデオバリアントを作成する)の配列を追加および管理できます variants
代替を提供する name
, description
, long_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.
サンプルレスポンス
{
"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.
変更するフィールドのみを含める必要があります。 リクエストの本文フィールドは、バリアントを作成する場合と同じですが、 してもいいです Studio上ではサポートされていません。 含める 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
応答。
バリアントは、を使用して取得できます。 Playback API など 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。 詳細については、次のトピックを参照してください。