トレンディングと人気コンテンツ

視聴者は、トレンディングを使って、人気のあるビデオやお客様が指定した期間に大幅に勢いを増したビデオを発見できます。

最も勢いのあるビデオを取得

[GET] /v2/discover/trending/momentum
   

最も人気のあるビデオの取得

[GET] /v2/discover/trending/top
    

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

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

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

評価する国を指定します。

タイプ:文字列

有効値: all | valid ISO-639-1 two-digit country codes

デフォルト: all

例: countries=us,uk,ca

いいえ
exclude_videos

結果から取り除くため、最大10個のembedコードをコンマ区切りで指定します。10本以上のビデオを取り除くなら、編集APIを使うことをご検討ください。

タイプ:文字列

デフォルト: なし

例: exclude_videos=hiamZvMjqKnLMr7xnMF-qcTEanQlhCQ1,pmd2xzMjrCg4TpQd6cwz9HP4U-pcFSHH

いいえ
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

いいえ
time

終了時間とデータを返す時間を指定します。たとえば、月間の枠で12月31日を指定すれば、12月から結果を返します。たとえば、週間の枠で12月31日を指定すれば、12月31日からとその前6日間のデータを返します。

Note: 30日前までの日付を指定できます。

タイプ:文字列

有効値: now | YYYY-MM-DD | YYYY-MM-DD-HH

デフォルト: now

例: time=2013-12-31

いいえ
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に挿入します)

いいえ
window

評価する時間枠を指定します。たとえば、よく利用するユーザーにその日最も人気のあるビデオを返し、あまり利用しないユーザーにはその週に人気のあるビデオを返すこともできます。

タイプ:文字列

有効な値: hour | day | week | month

デフォルト: day

例: window=week

いいえ

この例はその日最も人気がある5本のビデオを返します。

[GET] /v2/discover/trending/top?countries=all&time=now&window=day&limit=5

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

		{
		  "results": [
		    {
		      "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"
		    },
		    {
		      "name": "Cat Video #145678436",
		      "description": "Yet even more cats!",
		      "embed_code": "Z2dnRsNDrcK-ZaZrlFIZuTlPoDZ_RTfs",
		      "external_id": "cat:7880638",
		      "preview_image_url": "http://catscatscats.com/images/catvideo145678436.jpg",
		      "duration": "91000",
		      "hostedAtURL": null,
		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7tyRdfIlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":2}",
		      "reason": "top"
		    },
		    {
		      "name": "Cat Video #145678437",
		      "description": "Can you believe it?",
		      "embed_code": "Z2dnRsNDrcK-ZaZrlFITYnrPoDZ_RFtg",
		      "external_id": "cat:7880638",
		      "preview_image_url": "http://catscatscats.com/images/catvideo145678437.jpg",
		      "duration": "91000",
		      "hostedAtURL": null,
		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7tyRdfIlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":3}",
		      "reason": "top"
		    },
		    {
		      "name": "Dog Video #0000001",
		      "description": "Dogs",
		      "embed_code": "Z2dnRsNDrcK-ZaZrlFIZuTlPoDZ_tyHG",
		      "external_id": "dog:0000001",
		      "preview_image_url": "http://catscatscats.com/images/dogvideo0000001.jpg",
		      "duration": "91000",
		      "hostedAtURL": null,
		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7tyRdfIlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":4}",
		      "reason": "top"
		    }
		  ]}
    

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