順序関係の指定

順番に推奨したい一連のコンテンツがある場合、順序関係を構築することができます。

順序関係を使用して、コンテンツをシリーズとしてまとめることができます (例:エピソード1、エピソード2など)。加えて、コンテンツの一部とその”ハイライト場面”の間で、順序関係を作成することもできます。

順序関係を構築するには、カスタムメタデータエントリーをアセットに追加して、Ooyala Discoveryリクエストを発行する際に情報をリクエストするだけです。

  1. /v2/assetsルートでPATCHを使用して、現在のメタデータを置き換えることなくメタデータを追加します。 次の例はJxbzdkMjqBEsOアセットをシリーズの次のコンテンツとして追加し、RTffTGterfdcアセットをハイライト場面として追加しています。
    [PATCH] /v2/assets/RTydMjq34Yt/metadata
    {
      "next_item" : "JxbzdkMjqBEsO",
      "next_highlight" : "RTffTGterfdc"
    }
        

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

    {
      "next_item" : "JxbzdkMjqBEsO",
      "next_highlight" : "RTffTGterfdc",
      "director" : "George Lucas",
      "copyright" : "2010",
      "category": "Adventure",
      "external_id": "paint-drying:000242"
    }
         

    Sorting 試行する

  2. 次のアイテムをお勧めアイテムとして追加したい場合、unionクエリー文字列パラメータを使って位置を指定します。 次の例はその日に最も人気があった4本のビデオを返します。しかし、シリーズから次のアイテムを位置0に挿入して、ハイライト場面を位置2に挿入します。
    [GET] /v2/discover/trending/top?countries=all&time=now&window=day&limit=4&union=next|next_item|0,union=next|next_highlight|2
        

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

    		{
    		  "results": [
    		   {
    		      "name": "Extreme Paint Drying, Episode 243",
    		      "description": "Sunday! Sunday! Sunday! You watched episodes 1 through 242, now you are ready for 243!",
    		      "embed_code": "JxbzdkMjqBEsO",
    		      "external_id": "paint-drying:000243",
    		      "preview_image_url": "http://paint.com/images/paint-drying_000243.jpg",
    		      "duration": "91000",
    		      "hostedAtURL": null,
    		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7tyRdfIlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":0}",
    		      "reason": "next_item"
    		    },
    		    {
    		      "name": "More cats playing piano!",
    		      "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": "Extreme Paint Drying Highlights",
    		      "description": "The best moments from the Extreme Paint Drying Series, including 23 minutes from the chartreuse episode.",
    		      "embed_code": "RTffTGterfdc",
    		      "external_id": "paint-drying-highlights:00012",
    		      "preview_image_url": "http://paint.com/images/paint-drying-00012.jpg",
    		      "duration": "91000",
    		      "hostedAtURL": null,
    		      "bucket_info": "1{\"encoded\":\"eNpNjtsKhCAQht9lrmNR1+zwMiElrVAqOhtE27vv2Abr3fynjzkg6GgcDlsY\\n7tyRdfIlHNJw9oQKz5RT3YKDnFQQTRzL0TJI9WF2BXmYfLb7WgUh6TdAf\\nMEft3osmeydkxqBdaQF0pdFHcwMBfSCLhmjRepdy5SyZTl87pB+nRNVoxmGx\\nCa9Pn13N1e/TPislxF+1jZRFJmTRbEVTZG3HbgXnF+k0UNc=\",\"position\":0}",
    		      "reason": "next_item"
    		    },
    		    {
    		      "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/JxbzdkMjqBEsO">Extreme Paint Drying, Episode 243</a></p>
                <p>Sunday! Sunday! Sunday! You watched episodes 1 through 242, now you are ready for 243!</p>
            </li>
            <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/RTffTGterfdc">Extreme Paint Drying Highlights</a></p>
                <p>The best moments from the Extreme Paint Drying Series, including 23 minutes from the chartreuse episode.</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>    
        
       

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