アセットの置き換え

コンテンツの置き換えを実行すると、古いコンテンツを新しいコンテンツに置き換えられます。たとえば、技術的な 問題があるビデオがある場合や、複数のビデオのロゴを変更しなければならないことがあるかもしれません。

古いアセットと新しいアセットがほぼ同一であるなら、コンテンツの置き換えは古いアセットを削除して代替 アセットをアップロードする時間を省いてくれます。ラベル、シンジケーション設定、発行ルール などを更新する必要がありません。しかし、コンテンツの 置き換えを行うと、分析に影響ができます。たとえば、5分のビデオを15分のビデオに置き換える場合、 平均視聴時間の分析は意味がなくなり、エンゲージメントレポートの正確性が失われます。

注:

コンテンツの置き換えは、ビデオアセットへの使用を第一に考えられています。リモートアセットや ライブストリームのコンテンツを置き換える場合、その設定を変更するだけで済みます。

デフォルトのプレビュー画像を使っている場合、同画像は自動的に置き換えられます。カスタム プレビュー画像(アップロード画像、もしくはリモートURL経由の画像)を使用している場合、 引き続き新しいアセットに関連付けられます。

コンテンツを置き換える方法:

  1. リクエストボディのプロパティに/v2/assetsルート、アセットID、 /replacement修飾子を設定して、POSTを実行します。 次の例は、Y1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrlのコンテンツを置き換えます。
    注: 全ファイルを 一度にアップロードするには、chunk_sizeを指定しないでください。
    [POST] /v2/assets/Y1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrl/replacement
    {
      "file_size": 199895,
      "chunk_size": 100000
    }
        

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

    {
      "asset_type": "video",
      "duration": 0,
      "name": "My Video",
      "preview_image_url": null,
      "created_at": "2011-07-22T18:54:19+00:00",
      "embed_code": "Y1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrl",
      "time_restrictions": null,
      "updated_at": "2011-07-22T18:54:19+00:00",
      "external_id": null,
      "description": null,
      "status": "uploading"
    }
         

    Sorting 試行する

  2. /v2/assetsルート、 アセットID、/replacement修飾子と/uploading_urls修飾子へ GETを実行してファイルをアップロードするためのURLを 取得します。
    [GET] /v2/assets/Y1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrl/replacement/uploading_urls
        
    URLはレスポンスボディで返されます。
  3. 各チャンクをアップロードします。
    注: chunk_sizeを指定していない場合、チャンクの範囲を指定しないでください。
    次の例はY1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrlアセットの最初のチャンクをアップロードします。
    [PUT] https://uploader-v2.ooyala.com/send?filename=Y1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrl/0000000000000-0000000099999
    &filesize=100000
    &expires=1311447448
    &signature=tUp+iEUq9O9oP6khuasvZVFecoECcoej0gycG/ZTZr0
    <file>
    
  4. 置き換えるアセットのstatus/replacement/upload_statusuploadedに設定します。
    [PUT] /v2/assets/Y1dTdvMjq9QtOMGrP-H59OIgiZ6-_Mrl/replacement/upload_status
    { "status": "uploaded" }
                  

アセットはアップロードされたものとして設定されます。処理が終わると、現在のアセットを置き換え、利用可能になります。

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