概要：Playback API

賃貸システムの概要

Playback API Webページやモバイルアプリからビデオやプレイリストのデータを取得する際のクライアントサイドの使用を目的とした低遅延APIです。それは Studio上ではサポートされていません。 統合に使用する一般的なメディア管理API Video Cloud あなたのCMSや他のシステムでは、 CMS API.

Playback API 結果はフィルタリングされ、再生可能な動画のみが返されます（state = ACTIVE、取り込み完了フラグ= true、スケジュールされている場合は正しいデータ/時間）。これは、 player 他のレンディションがまだ処理中である場合でも、XNUMXつのレンディションが存在するとすぐにビデオを再生できます。現在再生できない動画を取得する必要がある場合は、もう一度 CMS API 代わりに。

パフォーマンスを最大化するために、アクセスするビデオデータは Playback API 短時間キャッシュされます。特定のデータセットIDがキャッシュされる期間は異なりますが、最大20分かかる場合があります。

また、 APIリファレンス.

ユースケース

Brightcove Player と Brightcove SDK players の方法と同じカタログ方法を含む Playback API実行時に再生するためにビデオやプレイリストを取得するだけであれば、ほとんどの場合、それらを使用することができます。

ただし、プレーヤーを表示していないモバイルアプリの画面で動画や再生リストを表示したい場合があります。

さらに、動画や再生リストを取得して、それらに関する情報を表示したい場合があります。 player たとえば、ビデオポータルのランディングページとして。

Playback API はこれらの場合に有用です。

一般情報

ベースURL

そのベースURL Playback API 次のとおりです。

https://edge.api.brightcove.com/playback/v1

アカウントパス

すべての場合において、要求は特定の Video Cloud アカウント。だから、あなたはいつもその言葉を追加するでしょう accounts アカウントIDをベースURLに続けて入力します。

https://edge.api.brightcove.com/playback/v1/accounts/{account_id}

認証

リクエストはポリシーキーによって認証され、次の3つの方法のいずれかで渡されます。

の議論では、 Accept ヘッダ：
```
Accept: application/json;pk={policy_key}
```
これは、ブラウザベースのクライアントに推奨される方法です。これは、ブラウザのCORSの「フライト前」チェックの一環として、最初に余分な要求を行わずに要求を進めることができるためです。これにより、ブラウザーの要求が初めて行われたときに待ち時間が節約されます。
で Authorization realmキーワードを使用したヘッダー BCOV-Policy:
```
Authorization: BCOV-Policy {policy_key}
```
で BCOV-Policy ヘッダ：
```
BCOV-Policy: {policy_key}
```

ポリシーキーの取得

ポリシーキーを取得するには、次の3つの方法があります。

すべてのブライトコーブ player 自動的に割り当てられます。を取得するための手順を見つけることができます playerのポリシーキーこの文書。ポリシーキーはアカウント全体で有効であるため、それが使用されているかどうかに関係なく使用できます。 player ページに埋め込まれています。
基本ポリシーキーを生成するには、ポリシーキーのクイックスタート
あなたは、 Policy API

トークン認証

HLSおよびDASHコンテンツのトークン認証がサポートされています。トークン認証が必要な場合は、アカウントマネージャーに連絡してアカウントで有効にしてください。

ハードコードされたURLを避ける

サムネイル、ポスター、ビデオファイル、およびその他のメディアのURLは、ページやアプリケーションにハードコードされてはなりません。ザ Playback API メディアファイルの最新のキャッシュバージョンのURLが返されますが、URL自体は変更される可能性があります。あなたは CMS API （または Playback API ）リクエストがページが読み込まれるたびにこれらのURLを取得するか、6時間を超えてキャッシュしません。

動画URLと画像URLのキャッシュ

動画や画像のURLをキャッシュしてページのパフォーマンスを向上させることはできますが、キャッシュは定期的に更新する必要があります。 ページのパフォーマンスを向上させるために取得したURLをキャッシュする場合は、少なくとも6時間に1度はAPI呼び出しを繰り返すことでキャッシュを更新してください。

メソッド

APIは、次のタイプのGETリクエストのみをサポートしています。

IDでビデオを取得する
参照IDでビデオを取得する
SSAIでビデオを入手する
ビデオを入手する
IDで再生リストを取得する
参照IDでプレイリストを取得する

ビデオリクエスト

1つのビデオオブジェクトは、ビデオIDまたは参照IDのいずれかを使用して取得できます。

IDでビデオを取得する

エンドポイント

https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}

例

https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos/38467382999

サンプルレスポンス

{
  "account_id": "107767373999",
  "ad_keys": null,
  "created_at": "2010-07-12T22:37:34.760Z",
  "description": "Avatar_MakingAScene_Featurette",
  "duration": 595560,
  "id": "38467382999",
  "long_description": null,
  "name": "Avatar_MakingAScene_Featurette",
  "published_at": "2010-07-12T22:37:34.760Z",
  "reference_id": "AvatarMakingShort",
  "text_tracks": [],
  "updated_at": "2010-07-12T22:54:29.666Z",
  "cue_points": [
    {
      "id": "111637107001",
      "name": "Pre-roll",
      "type": "AD",
      "time": 0,
      "metadata": null,
      "force_stop": false
    }
  ],
  "custom_fields": {
    "moretext": "this is the first video uploaded",
    "mylist": "abc"
  },
  "link": {
    "text": "Full Dvd at Amazon",
    "url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
  },
  "tags": [
    "copied"
  ],
  "poster_sources": [
    {
      "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
    }
  ],
  "thumbnail_sources": [
    {
      "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
    }
  ],
  "poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
  "thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
  "sources": [
    {
      "avg_bitrate": 379000,
      "width": 320,
      "duration": 595560,
      "size": 28196307,
      "stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
      "codec": "H264",
      "asset_id": "111728840001",
      "container": "MP4",
      "height": 180,
      "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
    },
    {
      "avg_bitrate": 379000,
      "width": 320,
      "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
      "size": 28196307,
      "height": 180,
      "duration": 595560,
      "container": "MP4",
      "codec": "H264",
      "asset_id": "111728840001"
    }, ... 6 more sources ...

  ]
}

参照IDでビデオを取得する

エンドポイント

https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/ref:{reference_id}

例

https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos/ref:nature_2010-07-12

サンプルレスポンス

{
  "account_id": "107767373999",
  "ad_keys": null,
  "created_at": "2010-07-12T22:37:34.760Z",
  "description": "Avatar_MakingAScene_Featurette",
  "duration": 595560,
  "id": "38467382999",
  "long_description": null,
  "name": "Avatar_MakingAScene_Featurette",
  "published_at": "2010-07-12T22:37:34.760Z",
  "reference_id": "nature_2010-07-12",
  "text_tracks": [],
  "updated_at": "2010-07-12T22:54:29.666Z",
  "cue_points": [
    {
      "id": "111637107001",
      "name": "Pre-roll",
      "type": "AD",
      "time": 0,
      "metadata": null,
      "force_stop": false
    }
  ],
  "custom_fields": {
    "moretext": "this is the first video uploaded",
    "mylist": "abc"
  },
  "link": {
    "text": "Full Dvd at Amazon",
    "url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
  },
  "tags": [
    "copied"
  ],
  "poster_sources": [
    {
      "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
    }
  ],
  "thumbnail_sources": [
    {
      "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
    }
  ],
  "poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
  "thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
  "sources": [
    {
      "avg_bitrate": 379000,
      "width": 320,
      "duration": 595560,
      "size": 28196307,
      "stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
      "codec": "H264",
      "asset_id": "111728840001",
      "container": "MP4",
      "height": 180,
      "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
    },
    {
      "avg_bitrate": 379000,
      "width": 320,
      "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
      "size": 28196307,
      "height": 180,
      "duration": 595560,
      "container": "MP4",
      "codec": "H264",
      "asset_id": "111728840001"
    }, ... 6 more sources ...

  ]
}

動画の検索

あなたは検索可能なポリシーキー、を使用して動画を検索するとき Playback API。詳細については、 Playback APIリファレンスの資料をご参照ください。

パラメーター

すべてのパラメータは任意。彼らはに適用されます GET Videos リクエストのみ。

GET動画のリクエストパラメータ
パラメーター	説明
`q`	検索のクエリ文字列 - 詳細は、検索ガイド
`limit`	返されるビデオの数 - 1と100の間の整数でなければなりません。デフォルト：20
`offset`	スキップするビデオの数（ページング結果用）。正の整数でなければなりません。デフォルト：0
`sort`	並べ替えるフィールドを指定する文字列。で始まる `-` 降順をソートする。値の場合 `q` が提供されている場合、デフォルトのソートは「スコア」（検索結果と元のクエリの関連性）です。値がない場合 `q` が提供されている場合、デフォルトのソートは `updated_at` 降順。ソートには次のフィールドが有効です。 `name`, `reference_id`, `created_at`, `published_at`, `updated_at`, `schedule_starts_at`, `schedule_ends_at`, `state`, `plays_total`および `plays_trailing_week` 詳細については、ビデオを入手するのセクション Playback API 参照

検索パラメータの使用

ブライトコーブ Playback API プログラム内で動画を検索する方法を提供します Video Cloud としょうかん。

ビデオデータの基本的な検索や複雑な検索を行うには、 q パラメータを使用します。

https://edge.api.brightcove.com/playback/v1/accounts/1752604051111/videos?q={search terms}

動画の検索方法の詳細については、検索動画の資料をご参照ください。

ページング結果

使用 limit 100までのリクエストで返すアイテムの数を指定するパラメータ。その後、 offset パラメータよりも大きい結果セットをページする limitとして指定することができます。 offset スキップする項目の数です。

たとえば、次の検索では、合計結果セットに少なくとも51ビデオがあると仮定して、合計結果セットのビデオ75-75が返されます。

/videos?q=updated_at:2014-01-01..2014-06-30&limit=25&offset=50

limit と offset パラメータは動画にのみ使用できます。

ページングのベストプラクティス

結果セットをページングするとき Playback API次の手順を実行することをお勧めします。

使用 limit と offset 結果セットからデータのグループを戻すためのパラメーター。
```
/accounts/578380111111/videos?q=tags:nature&limit=20&offset=50
```
それぞれの応答で、あなたは count フィールドには、結果セットの動画の最大数が常に表示されます。
```
{"count": 171,
  "videos": [ ... ]
}
```
ことを忘れないでください Playback API 検索は1000本の動画で制限されています。
コーヒー豆の水への溶解度は平均して count 最初のリクエストの動画を使用して、リクエストする必要のあるページ数を判断できます。

あるいは、 count それぞれのレスポンスで count ページサイズの limit.
```
count <= page-number * limit
```

動画の結果を並べ替える

パラメータを使用する sort=field_name 結果をソートする方法を指定します。次のビデオフィールドを並べ替えることができます：^[1-1]

フィールド名の前にマイナス記号（sort=-field_name）を降順で使用します。

名
reference_id
created_at
published_at
updated_at
schedule_starts_at（注：これは sort フィールド - 検索フィールドは schedule.starts_at)
schedule_ends_at（注：これは sort フィールド - 検索フィールドは schedule.ends_at)
状態
plays_total^[1-2]
plays_trailing_week^[1-2]

ノート

^[1-1] ビデオ検索呼び出しにソート値を指定しないと、結果は関連性によってソートされます。ソート値を指定しないと GET ビデオが呼び出されると、結果は updated_at 降順。
^[1-2] 並べ替えることができます plays_total or plays_trailing_weekこれらのフィールドは結果に含まれません

すべての動画と大きなデータセット

アカウント内のすべての動画や多数の動画を取得する場合は、次の点に注意する必要があります。

許可されている最大のものを使用するように誘惑されるかもしれません limit （100）ですが、25以下のバッチで動画を取得する方が、APIリクエストがタイムアウトする可能性を最小限に抑えることができます
大量のデータセットをページングしているとき、操作中にビデオデータが更新される可能性があります。そのため、アイテムのレスポンスが変化する可能性があります。
- 連続したページで項目が繰り返されることがあります
- 前の応答セットに移動したため、アイテムが見逃されることがあります
最初の可能性を考慮すると、動画の取得が完了した後に、アプリは完全なアイテムリストを重複排除する必要があります。 2つ目の可能性を処理するには、取得した項目の総数（期待していた数）を比較し、次にリクエストを再実行し、結果をlast_modified_date（降順）でソートする必要があります。 1つ以上のバッチを取り出して欠落したアイテムを取り出す。
返された結果を適切にソートすることで、前の項目のシナリオの可能性を減らすことができます。デフォルトのソート順は 関連性 キーワード、タグ、およびカスタムフィールド値の組み合わせを探す複雑なアルゴリズムに基づいています。複数のキーワード、タグ、および/またはカスタムフィールドに基づいて動画を検索している場合、関連性によるソートはまさにあなたが望むものです。ただし、すべての動画や大量の動画を取得しようとしているだけの場合は、 sort パラメータを明示的に指定すると、返される項目の順序をより詳細に制御できます。

ビデオを入手する

エンドポイント

https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos

例

https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos?q=tags:nature,name:nature

サンプルレスポンス

{
  "count": 123,
  "videos":
    [
      {<video1 fields>},
      {<video2 fields>},
      ...
    ]
}

エラー応答

検索キーではないポリシーキーを使用してビデオを取得しようとすると、次のエラーメッセージが表示されます。 Playback API:

[
  {
    "api_call": "search",
    "error_subcode": "API",
    "error_code": "ACCESS_DENIED",
    "message": "Access to this resource is forbidden by access policy."
  }
]

関連する動画をリクエストする
パラメーター	説明
`limit`	返す動画の数（デフォルト= 20、最大= 100）
`ad_config_id`	返品するad_config_idを追加する SSAIの動画

SSAIによるビデオリクエスト

Brightcove Webを使用していない場合でも player またはアプリケーションでBrightcove Native SDKを使用している場合でも、独自のサーバーサイド広告挿入（SSAI）を使用できます。 player.

SSAIでビデオを入手する

SSAIで動画を返信するには、広告設定IDをURLパラメータとして Playback API 要求。このリクエストでは、動画IDまたは動画参照IDのいずれかを使用できます。

エンドポイントURLパラメータ

追加する ad_config_id の終わりまで Playback API リクエスト：

https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}?ad_config_id={ad_config_id}

例

https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/5565662146001?ad_config_id=1234abcd

以下のサンプルレスポンスでは、次のことに気づくでしょう：

この応答は、広告の設定IDを含めなかった場合と同様です。
の要素 sources 配列には、 vmap.
コンテンツ内の広告の場所を知りたい場合は、リンク先のVMAPファイルを読むことができます。 vmap プロパティ。
src 内のプロパティ sources 配列には、HLSまたはDASHソースへのURLが含まれます。これは、広告設定IDが使用されていない場合の応答と同じですが、 src メインコンテンツにスティッチされた広告が表示されます。

サンプルレスポンス

{
  "description": "The story of a giant rabbit with a heart bigger than himself. ",
  "poster_sources": [
    {
      "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/3723496277001/dd5bd69c-e962-4a43-9dbd-94faaaba1785/main/1280x720/5m17s130ms/match/image.jpg"
    }
  ],
  "tags": [],
  "cue_points": [],
  "custom_fields": {},
  "account_id": "3723496277001",
  "sources": [
    {
      "ext_x_version": "4",
      "vmap": "http://ssaiplayback.prod.boltdns.net/playback/once/v1/vmap/hls/v4/clear/3723496277001/7a3316d9-1b06-4d62-bec8-3919b43fffbb/dd5bd69c-e962-4a43-9dbd-94faaaba1785/content.vmap?bc_token=NTllMTMxYjNfMTdkOTY2YThhNjU5MDk5ZTQ3NDBkNmUxOTYyOGRkNzM0ZjBiM2RjMGEwOThjOGFkYjk1MWQxMzFmNGYzMjA5YQ%3D%3D",
      "type": "application/x-mpegURL",
      "src": "http://ssaiplayback.prod.boltdns.net/playback/once/v1/hls/v4/clear/3723496277001/7a3316d9-1b06-4d62-bec8-3919b43fffbb/dd5bd69c-e962-4a43-9dbd-94faaaba1785/master.m3u8?bc_token=NTllMTMxYjNfZGM5ZDg0NGM2ZGJjZDcxZTFjOGYyODBlMzM2NmNmMmJkMWNhZDczNWViNzRiMjIwNjg5MjkzZGM0ZmJlMTc1Yw%3D%3D"
    },
    ...
  ],
  "created_at": "2017-05-15T17:09:11.171Z"
}

ad_config_idを要求する

使い方 Policy APIポリシーキーを作成すると、 ad_config_id リクエストを行う際のURLパラメータ Playback API。この機能の設定の詳細については、 Policy API 参照の資料をご参照ください。

ポリシーキーが要求するように設定されている場合 ad_config_id、あなたはそれを Playback API 次のエラーが表示されます。

[
  {
    "error_subcode": "AD_CONFIG",
    "error_code": "ACCESS_DENIED",
    "message": "Missing required ad_config_id parameter"
  }
]

プレイリストリクエスト

プレイリストビデオオブジェクトは、プレイリストIDまたはその参照IDのいずれかを使用して取得できます。

パラメーター

次のURLパラメータは、プレイリスト要求に使用できます

プレイリスト要求パラメータ
パラメーター	説明
制限	返す動画の数（デフォルト= 20、最大= 100）
オフセット	スキップする動画の数（プレイリストの先頭から、デフォルト= 0）

たとえば、あなたのリクエストに追加されたこれらのパラメータ - ？limit = 40＆offset = 20 - は、プレイリストに21-60という動画を返します（その数が多いと仮定します）。

IDで再生リストを取得する

エンドポイント

https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/playlists/{playlist_id}

例

https://edge.api.brightcove.com/playback/v1/accounts/57838016001/playlists/38467382999

サンプルレスポンス

{
  "account_id": "107767373999",
  "created_at": "2010-07-12T22:43:30.290Z",
  "description": null,
  "id": "111592530001",
  "name": "Play One",
  "reference_id": null,
  "type": "EXPLICIT",
  "updated_at": "2010-07-12T22:51:25.055Z",

  "videos": [
    {
      "description": "Avatar_MakingAScene_Featurette",
      "poster_sources": [
        {
          "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
        }
      ],
      "tags": [
        "copied"
      ],
      "cue_points": [
        {
          "id": "111637107001",
          "name": "Pre-roll",
          "type": "AD",
          "time": 0,
          "metadata": null,
          "force_stop": false
        }
      ],
      "custom_fields": {
        "moretext": "this is the first video uploaded",
        "mylist": "abc"
      },
      "account_id": "107767373999",
      "sources": [
        {
          "avg_bitrate": 379000,
          "width": 320,
          "duration": 595560,
          "size": 28196307,
          "stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111728840001",
          "container": "MP4",
          "height": 180,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 379000,
          "width": 320,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 28196307,
          "height": 180,
          "duration": 595560,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111728840001"
        },
        {
          "avg_bitrate": 267000,
          "width": 320,
          "duration": 595560,
          "size": 19894997,
          "stream_name": "mp4:107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111728852001",
          "container": "MP4",
          "height": 180,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 267000,
          "width": 320,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 19894997,
          "height": 180,
          "duration": 595560,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111728852001"
        },
        {
          "avg_bitrate": 549000,
          "width": 480,
          "duration": 595567,
          "size": 40889436,
          "stream_name": "mp4:107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111728860001",
          "container": "MP4",
          "height": 268,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 549000,
          "width": 480,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 40889436,
          "height": 268,
          "duration": 595567,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111728860001"
        },
        {
          "avg_bitrate": 835000,
          "width": 640,
          "duration": 595567,
          "size": 62142992,
          "stream_name": "mp4:107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111728865001",
          "container": "MP4",
          "height": 360,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 835000,
          "width": 640,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 62142992,
          "height": 360,
          "duration": 595567,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111728865001"
        },
        {
          "avg_bitrate": 1744000,
          "width": 640,
          "duration": 595567,
          "size": 129836869,
          "stream_name": "mp4:107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111735357001",
          "container": "MP4",
          "height": 360,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 1744000,
          "width": 640,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 129836869,
          "height": 360,
          "duration": 595567,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111735357001"
        },
        {
          "avg_bitrate": 1249000,
          "width": 640,
          "duration": 595567,
          "size": 92994065,
          "stream_name": "mp4:107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111735369001",
          "container": "MP4",
          "height": 360,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 1249000,
          "width": 640,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 92994065,
          "height": 360,
          "duration": 595567,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111735369001"
        }
      ],
      "name": "Avatar_MakingAScene_Featurette",
      "reference_id": "AvatarMakingShort",
      "long_description": null,
      "duration": 595560,
      "published_at": "2010-07-12T22:37:34.760Z",
      "text_tracks": [],
      "updated_at": "2010-07-12T22:54:29.666Z",
      "thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
      "poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
      "link": {
        "text": "Full Dvd at Amazon",
        "url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
      },
      "id": "38467382999",
      "ad_keys": null,
      "thumbnail_sources": [
        {
          "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
        }
      ],
      "created_at": "2010-07-12T22:37:34.760Z"
    }
  ],
}

参照IDでプレイリストを取得する

エンドポイント

https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/playlists/ref:{reference_id}

例

https://edge.api.brightcove.com/playback/v1/accounts/57838016001/playlists/ref:nature_2010-07-12

サンプルレスポンス

{
  "account_id": "107767373999",
  "created_at": "2010-07-12T22:43:30.290Z",
  "description": null,
  "id": "111592530001",
  "name": "Play One",
  "reference_id": nature_2010-07-12,
  "type": "EXPLICIT",
  "updated_at": "2010-07-12T22:51:25.055Z",

  "videos": [
    {
      "description": "Avatar_MakingAScene_Featurette",
      "poster_sources": [
        {
          "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
        }
      ],
      "tags": [
        "copied"
      ],
      "cue_points": [
        {
          "id": "111637107001",
          "name": "Pre-roll",
          "type": "AD",
          "time": 0,
          "metadata": null,
          "force_stop": false
        }
      ],
      "custom_fields": {
        "moretext": "this is the first video uploaded",
        "mylist": "abc"
      },
      "account_id": "107767373999",
      "sources": [
        {
          "avg_bitrate": 379000,
          "width": 320,
          "duration": 595560,
          "size": 28196307,
          "stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111728840001",
          "container": "MP4",
          "height": 180,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 379000,
          "width": 320,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 28196307,
          "height": 180,
          "duration": 595560,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111728840001"
        },
        {
          "avg_bitrate": 267000,
          "width": 320,
          "duration": 595560,
          "size": 19894997,
          "stream_name": "mp4:107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111728852001",
          "container": "MP4",
          "height": 180,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 267000,
          "width": 320,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 19894997,
          "height": 180,
          "duration": 595560,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111728852001"
        },
        {
          "avg_bitrate": 549000,
          "width": 480,
          "duration": 595567,
          "size": 40889436,
          "stream_name": "mp4:107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111728860001",
          "container": "MP4",
          "height": 268,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 549000,
          "width": 480,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 40889436,
          "height": 268,
          "duration": 595567,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111728860001"
        },
        {
          "avg_bitrate": 835000,
          "width": 640,
          "duration": 595567,
          "size": 62142992,
          "stream_name": "mp4:107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111728865001",
          "container": "MP4",
          "height": 360,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 835000,
          "width": 640,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 62142992,
          "height": 360,
          "duration": 595567,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111728865001"
        },
        {
          "avg_bitrate": 1744000,
          "width": 640,
          "duration": 595567,
          "size": 129836869,
          "stream_name": "mp4:107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111735357001",
          "container": "MP4",
          "height": 360,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 1744000,
          "width": 640,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 129836869,
          "height": 360,
          "duration": 595567,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111735357001"
        },
        {
          "avg_bitrate": 1249000,
          "width": 640,
          "duration": 595567,
          "size": 92994065,
          "stream_name": "mp4:107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
          "codec": "H264",
          "asset_id": "111735369001",
          "container": "MP4",
          "height": 360,
          "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
        },
        {
          "avg_bitrate": 1249000,
          "width": 640,
          "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
          "size": 92994065,
          "height": 360,
          "duration": 595567,
          "container": "MP4",
          "codec": "H264",
          "asset_id": "111735369001"
        }
      ],
      "name": "Avatar_MakingAScene_Featurette",
      "reference_id": "AvatarMakingShort",
      "long_description": null,
      "duration": 595560,
      "published_at": "2010-07-12T22:37:34.760Z",
      "text_tracks": [],
      "updated_at": "2010-07-12T22:54:29.666Z",
      "thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
      "poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
      "link": {
        "text": "Full Dvd at Amazon",
        "url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
      },
      "id": "38467382999",
      "ad_keys": null,
      "thumbnail_sources": [
        {
          "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
        }
      ],
      "created_at": "2010-07-12T22:37:34.760Z"
    }
  ],
}

キャプション

クローズドキャプションは、ビデオにアクセスしたい人のために、ビデオに関する追加情報を提供します。キャプションは、あなたのビデオのオーディオ部分にアクセスするために聴覚障害者や聴覚障害者にとって必要です。キャプションが初めての方は、概要：ビデオにキャプションを追加するの資料をご参照ください。

外部WebVTT

外部WebVTTキャプションは、ビデオとは別のテキストファイルです。次のようにキャプションファイルをビデオに関連付けることができます。

サンプルレスポンス

以下は、 Playback API WebVTTキャプションファイルがMediaモジュールを使用してビデオに追加されています。テキストトラック src プロパティは外部キャプションファイルをポイントします。

{
"text_tracks": [
{
  "mime_type": null,
  "account_id": "20318290001",
  "default": true,
  "sources": [
    {
      "src": "https://static.3playmedia.com/p/files/2240988/threeplay_transcripts/6418302.vtt?project_id=10127&format_id=51&refresh=1515241856"
    }
  ],
  "src": "https://static.3playmedia.com/p/files/2240988/threeplay_transcripts/6418302.vtt?project_id=10127&format_id=51&refresh=1515241856",
  "asset_id": null,
  "label": "English",
  "id": "13d66def-d004-4e75-b160-4ac693eff7d7",
  "kind": "captions",
  "srclang": "en"
}
],
}

インマニフェストWebVTT

マニフェスト内のWebVTTキャプションは、あなたのビデオと共に取り込まれます。これは、動画を最初に取り込んだとき、または動画が取り込まれた後に行うことができます。次のように、マニフェスト内のキャプションを作成できます。

サンプルレスポンス

以下は、 Playback API WebVTTキャプションファイルが Dynamic Ingest API。テキストトラック src プロパティは内部のBrightcoveファイルを指します。

{
"text_tracks": [
{
  "mime_type": "text/webvtt",
  "account_id": "1752604059001",
  "default": false,
  "sources": [
    {
      "src": "http://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173"
    },
    {
      "src": "https://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173"
    }
    ],
  "src": "http://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173",
  "asset_id": null,
  "label": "EN",
  "id": "92cb36a7-c836-4506-a87f-f649316c0cdf",
  "kind": "captions",
  "in_band_metadata_track_dispatch_type": "",
  "srclang": "en"
}
],
}

マニフェスト

HLSまたはDASHビデオファイルのマニフェストには、WebVTTキャプションを含めるために必要な情報も含まれています。

HLS

#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio-0",NAME="en (Main)",DEFAULT=YES,AUTOSELECT=YES,LANGUAGE="en",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/8b12c808-c5ea-47f3-abfa-c23b023db297/10s/rendition.m3u8?fastly_token=NWE3YjU3ZThfNzAwNTczOWM4MWQ4Mzk2NjFkYjVjYmFhYjQwNzY2MWUzM2MyNDM5ZDA5ZGExYTFkMzRmYzA0MDdhOTlmZWJhMw%3D%3D"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subtitles-0",NAME="EN",DEFAULT=YES,AUTOSELECT=YES,LANGUAGE="en",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/rendition.m3u8?fastly_token=NWE3YjU3ZThfNDYzOThkZGJiZTU1NTlhOTdkYzA5OTA3M2UzZGRlYTgzMmRkZmUxMGIxYTJkY2Y5ZDQ1ODFiNTEyMmNiZDVhMw%3D%3D"
#EXT-X-STREAM-INF:PROGRAM-ID=0,BANDWIDTH=519200,CODECS="mp4a.40.2,avc1.420015",RESOLUTION=480x270,AUDIO="audio-0",CLOSED-CAPTIONS=NONE,SUBTITLES="subtitles-0"
https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/5f7850d9-9a65-4eee-8810-86a1e18e05fb/10s/rendition.m3u8?fastly_token=NWE3YjU3ZThfY2Q5YmE2ODc2OWFiNTgyZjUxMjc1MzRhNmQxMzA0ZmJmY2RlMGU4ZjBiNDExZGRmNjc3YjQ0OGQ5N2RiOTVmMA%3D%3D

ダッシュ

<AdaptationSet mimeType="text/vtt" lang="en">
<Representation bandwidth="256" id="92cb36a7-c836-4506-a87f-f649316c0cdf">
  <BaseURL>http://bcboltbde696aa-a.akamaihd.net/media/v1/dash/live/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf.vtt?akamai_token=exp=1518032494~acl=/media/v1/dash/live/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a*~hmac=3e2edc412c273f1255f2c18bbbcee7afc6a2edb74573f9295b0f05feda69f0e2</BaseURL>
</Representation>
</AdaptationSet>

ページ内容

概要：Playback API

賃貸システムの概要

ユースケース

一般情報

ベースURL

アカウントパス

認証

ポリシーキーの取得

トークン認証

ハードコードされたURLを避ける

動画URLと画像URLのキャッシュ

メソッド

ビデオリクエスト

IDでビデオを取得する

エンドポイント

例

サンプルレスポンス

参照IDでビデオを取得する

エンドポイント

例

サンプルレスポンス

動画の検索

パラメーター

検索パラメータの使用

ページング結果

ページングのベストプラクティス

動画の結果を並べ替える

すべての動画と大きなデータセット

ビデオを入手する

エンドポイント

例

サンプルレスポンス

エラー応答

関連動画を探す

パラメーター

動画IDを使用して関連動画を取得する

エンドポイント

例

参照IDを使用して関連動画を取得する

エンドポイント

例

サンプルレスポンス

エラー応答

SSAIによるビデオリクエスト

SSAIでビデオを入手する

エンドポイントURLパラメータ

例

サンプルレスポンス

ad_config_idを要求する

プレイリストリクエスト

パラメーター

IDで再生リストを取得する

エンドポイント

例

サンプルレスポンス

参照IDでプレイリストを取得する

エンドポイント

例

サンプルレスポンス

キャプション

外部WebVTT

サンプルレスポンス

インマニフェストWebVTT

サンプルレスポンス

マニフェスト

HLS

ダッシュ