フィルタリング結果

ウェブサイトに多様なコンテンツがある場合、特定のフィルタで結果を制限することがあるかもしれません。たとえば、スポーツ関連のコンテンツがあるとして、フットボールのビデオを見ている視聴者へ人気のあるアイススケートのビデオをOoyala Discoveryに推奨させようとはしないはずです。そして、視聴者の言語でお勧めを表示するようにしたいはずです。

Ooyala Discoveryは特定のラベルや共有されたラベルに基づいて結果をフィルタリングできます。特定のラベルで、結果の範囲内のコンテンツに割り当てられている1つ以上のラベルを指定します。共有されたラベルで、視聴されているビデオとお勧めの間で共有済みであるという値を持つラベルを指定します。

推奨のフィルタリング:

  1. ラベルを指定したい場合、filter_byクエリー文字列パラメータを使い、ラベルのカンマ区切りの一覧を入力します。 次の例はcatまたはpianoラベルが付いたその日に最も人気があった2本のビデオを返します。
    [GET] /v2/discover/trending/top?countries=all&time=now&window=day&limit=2&filter_by=cat,piano
        

    Backlot は次のようなレスポンスを返します。

    		{
    		  "results": [
    		    {
    		      "name": "Cat Piano Video #1456",
    		      "description": "More cats playing piano!",
    		      "embed_code": "Jr8fdsNDrcK-TYHGlFIZuTlPoDZ_QkW3",
    		      "external_id": "cat:7880638",
    		      "preview_image_url": "http://catscatscats.com/images/catvideo1456.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 #1457",
    		      "description": "Even more cats playing piano!",
    		      "embed_code": "3556csNDrcK-ZaRTYhuTlPoDZ_tyrD",
    		      "external_id": "cat:7880638",
    		      "preview_image_url": "http://catscatscats.com/images/catvideo1457.jpg",
    		      "duration": "91000",
    		      "hostedAtURL": null,
    		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7tyRdfIlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":1}",
    		      "reason": "top"
    		    }
    		  ]}
        

    Sorting 試行する

  2. サブラベルを共有するお勧めビデオとソースビデオが必要な場合、filter_byクエリー文字列パラメータを使い、共有するサブラベルを入力します。 次の例は、現在のビデオとサブラベルを共有するビデオで、その日最も人気があった2本のビデオを返しています(animal/cat、instrument/pianoとlanguage/english)。
    [GET] /v2/discover/trending/top?countries=all&time=now&window=day&limit=2&filter_by=shared:animal,shared:instrument,shared:language
        

    Backlot は次のようなレスポンスを返します。

    		{
    		  "results": [
    		    {
    		      "name": "Cat Piano Video #1456",
    		      "description": "More cats playing piano!",
    		      "embed_code": "Jr8fdsNDrcK-TYHGlFIZuTlPoDZ_QkW3",
    		      "external_id": "cat:7880638",
    		      "preview_image_url": "http://catscatscats.com/images/catvideo1456.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 #1457",
    		      "description": "Even more cats playing piano!",
    		      "embed_code": "3556csNDrcK-ZaRTYhuTlPoDZ_tyrD",
    		      "external_id": "cat:7880638",
    		      "preview_image_url": "http://catscatscats.com/images/catvideo1457.jpg",
    		      "duration": "91000",
    		      "hostedAtURL": null,
    		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7tyRdfIlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":1}",
    		      "reason": "top"
    		    }
    		  ]}
        

    Sorting 試行する

  3. 各結果から情報を取得して、ウェブページのコンテンツを生成します。 次の例にはシンプルなHTMLコンテンツが含まれています。
    <div class="sidebar">
        <h4 class="sidebar-head">Popular Now</h4>
        <ul>
            <li>
                <p><a href="/video/Jr8fdsNDrcK-TYHGlFIZuTlPoDZ_QkW3">Cat Video #1456</a></p>
                <p>More cats playing piano!</p>
            </li>
            <li>
                <p><a href="/video/3556csNDrcK-ZaRTYhuTlPoDZ_tyrD">Cat Video #1457</a></p>
                <p>Even more cats playing piano!</p>
            </li>        
        </ul>
    </div>    
        
       

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