入門
しばらくしてからビデオを再生できないようにする理由はいくつかあります。例は次のとおりです。
- まだレビュー中です
- まだ公開されていない映画の予告編です
- これは、まだ開始されていない、または終了していないマーケティングキャンペーンの一部です。
- まだ公開されていないニュース記事の一部です
動画埋め込みコードをまだ公開ページやアプリに配置していない場合は、もちろん表示できませんが、誤って動画を公開する可能性があります。最も明白なのは、タグやその他のプロパティがスマートに適合していることです。公開されているプレイリスト。
VideoCloudビデオを表示できないようにする方法は2つあります。
- 非アクティブ化
- 将来のある時点で再生できるようにスケジュールします
これらの変更は両方ともStudioのMediaモジュールを介して実装できますが、ここでは、 CMS API。これらのアクションは両方とも、ビデオ更新リクエスト。
認証
へのリクエストCMS APIアクセストークンを含む認証ヘッダーが必要です。クライアントクレデンシャルを取得してアクセストークンを取得する方法の詳細については、「 Brightcove OAuth の概要」を参照してください。
を使用してクライアントの資格情報を作成できますスタジオ管理ページまたはOAuth API
また、使用することができますOAuth APIアクセストークンを直接取得する場合、またはを使用している場合郵便配達員また不眠症アプリまたはリクエストを行うには、アクセストークンをフェッチするようにこれらを設定する方法に関するチュートリアルを参照してください。
ビデオの更新リクエスト
ビデオを更新するには、パッチリクエストする
https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id通常、リクエストの本文には、更新するフィールドのみを含める必要がありますが、現在の値で他のフィールドを含めることもできます。次のセクションでは、アクティブ化/非アクティブ化およびスケジューリングのリクエスト本文を確認します。
ビデオをアクティブ化/非アクティブ化
ビデオを設定することにより、ビデオをアクティブ（表示可能）または非アクティブ（非表示）にします州。デフォルトでは、ビデオはアクティブそれらが取り込まれると（ビデオの作成時に省略された、またはアップロードモジュールを使用してアップロードされた必須フィールドがない場合）。
次に、ビデオを非アクティブ化するには、ビデオの更新要求とともに次の要求本文を送信する必要があります。
{
"state": "INACTIVE"
}ビデオが非アクティブになったことを確認するには、州 API応答のフィールド
レスポンスの例
{
"id": "1698990613556232930",
"account_id": "57838016001",
"ad_keys": null,
"clip_source_video_id": null,
"complete": true,
"created_at": "2021-05-06T06:48:31.963Z",
"created_by": {
"type": "unknown"
},
"cue_points": [
],
"custom_fields": {
},
"delivery_type": "dynamic_origin",
"description": "Updated at: 2021-05-07T22:37:46.492Z",
"digital_master_id": null,
"duration": 41259,
"economics": "AD_SUPPORTED",
"folder_id": null,
"geo": null,
"has_digital_master": true,
"images": {
"poster": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/1280x720/20s629ms/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/1280x720/20s629ms/match/image.jpg",
"height": 720,
"width": 1280
}
]
},
"thumbnail": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/160x90/20s629ms/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/160x90/20s629ms/match/image.jpg",
"height": 90,
"width": 160
}
]
}
},
"link": null,
"long_description": null,
"name": "Great Horned Owl",
"original_filename": "greathornedowl.mp4",
"projection": null,
"published_at": "2021-05-06T06:48:31.963Z",
"reference_id": "greathornedowl.mp4_1620283704192",
"schedule": null,
"sharing": null,
"state": "INACTIVE",
"tags": [
"bird",
"air",
"nature"
],
"text_tracks": [
],
"updated_at": "2021-05-16T22:54:09.168Z",
"updated_by": {
"type": "api_key",
"email": "rcrooks@brightcove.com"
},
"offline_enabled": false,
"playback_rights_id": "primary"
}動画を再びアクティブにするには、リクエスト本文を使用して別の動画更新リクエストを送信するだけです。
{
"state": "ACTIVE"
}ビデオをスケジュールする
ビデオを再生可能または再生不可能にする2番目の方法は、スケジュール動画更新リクエストのオブジェクト。NS スケジュールオブジェクトには2つのプロパティがあります。
start_atビデオが再生可能になるISO-8601日時（必須）extends_atビデオが再生できなくなったISO-8601日時（オプション）
これは、2021年5月16日の午前6:00（UTC）に動画を再生可能にし、ちょうど1年後に再び再生不可能にするリクエスト本文のサンプルです。
{
"schedule": {
"starts_at": "2021-05-16T06:00:00.000Z",
"ends_at": "2022-05-16T06:00:00.000Z"
}
}レスポンスの例
{
"id": "1698990613556232930",
"account_id": "57838016001",
"ad_keys": null,
"clip_source_video_id": null,
"complete": true,
"created_at": "2021-05-06T06:48:31.963Z",
"created_by": {
"type": "unknown"
},
"cue_points": [
],
"custom_fields": {
},
"delivery_type": "dynamic_origin",
"description": "Updated at: 2021-05-07T22:37:46.492Z",
"digital_master_id": null,
"duration": 41259,
"economics": "AD_SUPPORTED",
"folder_id": null,
"geo": null,
"has_digital_master": true,
"images": {
"poster": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/1280x720/20s629ms/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/1280x720/20s629ms/match/image.jpg",
"height": 720,
"width": 1280
}
]
},
"thumbnail": {
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/160x90/20s629ms/match/image.jpg",
"sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/160x90/20s629ms/match/image.jpg",
"height": 90,
"width": 160
}
]
}
},
"link": null,
"long_description": null,
"name": "Great Horned Owl",
"original_filename": "greathornedowl.mp4",
"projection": null,
"published_at": "2021-05-06T06:48:31.963Z",
"reference_id": "greathornedowl.mp4_1620283704192",
"schedule": {
"ends_at": "2022-05-16T06:00:00.000Z",
"starts_at": "2021-05-16T06:00:00.000Z"
},
"sharing": null,
"state": "ACTIVE",
"tags": [
"bird",
"air",
"nature"
],
"text_tracks": [
],
"updated_at": "2021-05-17T00:42:45.172Z",
"updated_by": {
"type": "api_key",
"email": "rcrooks@brightcove.com"
},
"offline_enabled": false,
"playback_rights_id": "primary"
}