パーソナライズされたお勧め

パーソナライズされた推奨APIは、デバイスユーザーの視聴履歴を基本としたユーザーの好みを返します。

たとえば、視聴者がAndroid タブレットを使って、投資に関するビデオを見るとすると、Ooyala Discoveryは他の投資とビジネスに関するビデオを返します。デフォルトでデバイスIDに履歴がなければ、Ooyala Discoveryアルゴリズムは視聴者が現在視聴しているものに関するコンテンツを返します。コンテンツを視聴していなければ、Ooyala Discoveryアルゴリズムは現在人気のコンテンツを返します。

カスタムビデオの取得

[GET] /v2/discover/personal/device_id
    

ルート属性

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

ルート属性 説明
device_id

お勧めを返したいデバイスかユーザーのID。

タイプ:文字列

デフォルト:なし

例: 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に挿入します)

いいえ

次の例は、デバイスth53THYsdRdsに対して2つのパーソナライズされたお勧めを返します。

[GET] /v2/discover/personal/th53THYsdRds?limit=2

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

		    {
		      "name": "Cat Video #145678434",
		      "description": "More cats!",
		      "embed_code": "Z2dnRsNDrcK-TYHGlFIZuTlPoDZ_QkW3",
		      "external_id": "cat:7880638",
		      "preview_image_url": "http://catscatscats.com/images/catvideo145678434.jpg",
		      "duration": "91000",
		      "hostedAtURL": null,
		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7tyRdfIlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":0}",
		      "reason": "top"
		    },
		    {
		      "name": "Cat Video #145678435",
		      "description": "Even more cats!",
		      "embed_code": "Z2dnRsNDrcK-ZaRTYhuTlPoDZ_tyrD",
		      "external_id": "cat:7880638",
		      "preview_image_url": "http://catscatscats.com/images/catvideo145678435.jpg",
		      "duration": "91000",
		      "hostedAtURL": null,
		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7tyRdfIlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":1}",
		      "reason": "top"
		    }
		  ]}
    

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