類似のビデオ

Ooyala Discoveryの類似ビデオAPIは、指定したビデオに類似するビデオを返します。たとえば、視聴者がスカイダイビングのビデオを見ているなら、Ooyala Discoveryアルゴリズムはスカイダイビング、またはエクストリームスポーツのビデオを返します。

類似するビデオの取得

[GET] /v2/discover/similar/assets/embed_code
    

類似するリモートアセットの取得

[GET] /v2/discover/similar/externalassets/embed_code
    

ライブストリームコンテンツに類似するビデオの取得

[GET] /v2/discover/similar/live_assets/virtual_asset_id
    

ルート属性

次の表はすべてのルート属性を示します。

ルート属性 説明
embed_code

関連するビデオを収集したいビデオかリモートアセットのembedコードを指定します。

タイプ:文字列

デフォルト:なし

例: pmd2xzMjrCg4TpQd6cwz9HP4U-pcFSHH

virtual_asset_id

ライブストリーム内でバーチャルアセットのIDを指定します。バーチャルアセットのIDを指定するには、Electronic Programming Guide (EPG)がアカウントに対して有効でなければいけません。EPGについての詳しい情報は、営業、カスタマーサクセスマネージャー、またはテクニカルサポートまでお問い合わせください。

タイプ:文字列

デフォルト:なし

例: pmd2xzMjrCg4TpQd6cwz9HP4U-pcFSHH

クエリー文字列パラメータ

次の表はルートのクエリー文字列パラメータを説明しています。

Note: 明確にするため、この例ではURLエンコードされていませんが、実際には、すべてのクエリー文字列パラメータと値はURLエンコードするようにします。
パラメータ 説明 必須?
filter_by

編集関数の一部で、指定のラベルに結果を制限します。

タイプ:文字列

デフォルト:なし

例:

filter_by=cat ("cat"を含むラベル)

filter_by=cat,piano ("cat"または"piano"を含むラベル)

filter_by=shared:language ("/language/english"のように"language"をサブラベルに含むコンテンツ)

filter_by=cat,shared:language ("cat"のラベルと同じ言語のサブラベルがあるラベル)

いいえ
limit

返される結果の最大数。

タイプ:整数

デフォルト:10

有効値:1-100

例: limit=20

いいえ
union

編集機能の一部で、挿入するコンテンツとロケーションを結果で指定します。

タイプ:文字列

デフォルト:なし

例:

union=next|next_item|0 ( next_item コンテンツメタデータエントリーで指定されたアセットを結果0ポジションに挿入します)

union=n|next_item|0 (前例のショートカット)

union=next|next_item|0,union=next|next_highlight|2 (next_item コンテンツをメタデータに入力して指定したアセットを結果0ポジションに挿入し、 next_highlights コンテンツをメタデータに入力して指定したアセットをポジション2に挿入します)

union=collection|2012-09_extreme_paint|1 (2012-09_extreme_paint コレクションからプロモーションコンテンツをポジション1に挿入します)

union=c|2012-09_extreme_paint|1 (前例のショートカット)

union=collection|live|1 (ライブのアセットをポジション1に挿入します)

union=collection|label:BasketballPromo|0 (BasketballPromoラベルからプロモーションコンテンツをポジション0に挿入します)

union=collection|label:BasketballPromo|0|2012-10-29|2012-10-31 (2012年10月29日から2012年10月31日までBasketballPromoからプロモーションコンテンツをポジション0に挿入します)

いいえ

この例はアセットxtNnJ4OkQzLNI1wI2rYDvl5saZphlRaIに関連する2本のビデオを返します。

[GET] /v2/discover/similar/assets/xvYXRnMTq9mUtxDdI7DejR6qeOEy67-h?limit=2

以下のようなレスポンスを返します。

		{
		  "results": [
		    {
		      "name": "Highlight Of The Night",
		      "description": "76ers take advantage of Derrick Rose's absence in Game 2 and roll to 109-92 win.",
		      "embed_code": "Z2dnRsNDrcK-ZaZrlFIZuTlPoDZ_QkW3",
		      "external_id": "espn:7880638",
		      "preview_image_url": "http://vod.espn.go.com/images/2012/0502/dm_120502_sc_highlight.jpg",
		      "duration": "91000",
		      "hostedAtURL": null,
		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7AQ9qE4oydlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":0}",
		      "reason": "top"
		    },
		    {
		      "name": "Kobe, Lakers Take 2-0 Lead",
		      "description": "Kobe Bryant scores 38 to lead the Lakers to the 104-100 win over Nuggets.",
		      "embed_code": "R3eXRsNDpA53ONkBxNcwr3JoYx04BLG2",
		      "external_id": "espn:7880799",
		      "preview_image_url": "http://vod.espn.go.com/images/2012/0502/dm_120502_lakers_nuggets.jpg",
		      "duration": "61000",
		      "hostedAtURL": null,
		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7AQ9qE4oydlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":1}",
		      "reason": "top"
		    }
		  ]}
    

この記事はお役にたちましたか?