入門
国際的なオーディエンス（または同じ国内に多言語）がいる場合は、タイトルや説明などの動画メタデータを複数の言語で提供することができます。
Video Cloud では、次の多言語バージョンを使用できます。
- images
- テキストトラック
- 名前 (経由
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-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 を使用して、代替言語の画像とテキストトラックを追加できます。詳細については、次のトピックを参照してください。