入門
テキストトラックが取り込まれるか（静的または動的）、リモートであるかに関係なく、パッチテキストトラックに関連付けられたメタデータを更新するように要求します。
注
- このドキュメントで説明されている方法は、ビデオに追加されたWebVTTファイルを更新するためのものです。を使用してWebVTTファイルをVideoCloudに取り込むことができますDynamic Ingest APIまたリモートWebVTTファイルを追加する CMS APIを使用して動画に追加します。
認証
CMS APIへのリクエストには、アクセストークンを含む認証ヘッダーが必要です。クライアントクレデンシャルを取得してアクセストークンを取得する方法の詳細については、「 Brightcove OAuth の概要」を参照してください。
ビデオメタデータを更新するために必要な操作は次のとおりです。video-cloud/video/updateまたはvideo-cloud/video/all。
構文
完全な配列を取得するには、最初に次のリクエストを行うことをお勧めします。
GET
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_ID}
テキストトラックの更新
テキストトラックを更新する場合、テキストトラックフィールドタイプに応じて異なる方法で扱うことができます。
| フィールド | タイプ | リモートテキストトラック | 静的に取り込まれたテキストトラック | 動的に取り込まれたテキストトラック |
|---|---|---|---|---|
id |
文字列 | 読み取り専用の値。更新が必要なTTを特定するために必要です。 | ||
account_id |
文字列 | このフィールドの更新は無視されます。 | ||
src |
文字列 | 必須で、255文字に制限されています。 | このフィールドの更新は無視されます。 | |
srclang |
文字列 | 32文字に制限されています。 | ||
ラベル |
文字列 | 255文字に制限されています。 | ||
親切 |
列挙型 | 有効な値は次のとおりです字幕、キャプション、説明、章、メタデータ。大文字と小文字を区別。 |
||
mime_type |
文字列 | 32文字に制限されています。 | このフィールドの更新は無視されます。 | |
Asset_id |
文字列 | 読み取り専用の値。 | このタイプには適用されないフィールド。このフィールドの更新は無視されます。 | |
in_band_metadata_track_dispatch_type |
文字列 | このタイプには適用されないフィールド。 | このフィールドの更新は無視されます。 | |
ソース |
配列 | 読み取り専用の値。 | ||
ディフォルト |
ブール値 | NSまたNS。複数追加することはできませんdefault = true異なるテキストトラックにsrclang。 |
このフィールドの更新は無視されます。 | |
要求
リモート、静的、動的テキストトラックに適用できます。
PATCH
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_ID}
リクエスト本文の例
リモートテキストトラック
リクエストの本文は、テキストトラックの配列を含むJSONオブジェクトになります。
{
"text_tracks" :
[
{
"id" : "1234-1234-1234"
"src" : "http://learning-services-media.brightcove.com/captions/bc_smart_ja. vtt",
"srclang" : "ja",
"label" : "日本人",
"kind" : "captions",
"mime_type" : null,
"default" : true
},
{
"id" : "5678-5678-5678"
"src" : "http://learning-services-media.brightcove.com/captions/bc_smart_es. vtt",
"srclang" : "es",
"label" : "español",
"kind" : "descriptions",
"mime_type" : null,
"default" : false
}
]
}静的テキストトラック
リクエストの本文は、テキストトラックの配列を含むJSONオブジェクトになります。
{
"text_tracks" :
[
{
"id" : "1234-1234-1234"
"srclang" : "ja",
"label" : "日本人",
"kind" : "captions",
"mime_type" : null,
"default" : true
},
{
"id" : "5678-5678-5678"
"srclang" : "es",
"label" : "español",
"kind" : "descriptions",
"mime_type" : null,
"default" : false
}
]
}動的テキストトラック
リクエストの本文は、テキストトラックの配列を含むJSONオブジェクトになります。
{
"text_tracks" :
[
{
"id" : "1234-1234-1234"
"srclang" : "ja",
"label" : "日本人",
"kind" : "captions",
"mime_type" : null,
"default" : true
},
{
"id" : "5678-5678-5678"
"srclang" : "es",
"label" : "español",
"kind" : "descriptions",
"mime_type" : null,
"default" : false
}
]
}