発行ルール

発行ルールを使用して、どこで、いつコンテンツが再生可能かを指定します。発行ルールを使用すると、コンテンツを特定の地域に制限したり、特定のドメインだけに埋め込みを許可、そして一定回数しか再生を許可しないように制限をかけることができます。

アセットが読み込まれると、再生を開始する前に発行ルールを確認します。作成した各ルールは これら制限を好きなように組み合わせることができ、複数のビデオやチャンネルに割り当てることができます。

Note: Backlot UI内では、発行ルールをシンジケーショングループと呼びます。

新規発行ルールの追加

[POST] /v2/publishing_rules
{
     properties
}
   

発行ルール一覧

[GET] /v2/publishing_rules
   

発行ルールの取得

[GET] /v2/publishing_rules/publishing_rule_id
   

発行ルールの修正

[PATCH] /v2/publishing_rules/publishing_rule_id
{
     properties
}
   

発行ルールの削除

[DELETE] /v2/publishing_rules/publishing_rule_id
   

ルート属性

次の表はルートに表示されるすべて属性を示しています。

ルート属性 説明
publishing_rule_id

発行ルールのID。発行ルール一覧を取得するために、/publishing_rulesルートに対してGETを実行してください。

タイプ:文字列

デフォルト:なし

例:/publishing_rules/ru1ze4ea4e648fd07d4509123254

プロパティ

次の表はラベルと関連付けることができるすべてのプロパティを示しています。

プロパティ 説明 必須?
all_day

コンテンツが1日中再生可能かどうかを指定します。

タイプ:ブーリアン

有効値: true | false

条件:タイプが"recurring"でstart_timeおよびend_timeが指定されていない場合、必須。

例: true

親: time_restrictions

条件付き
allowed_devices

許可されたデバイスを特定します。

タイプ:配列

有効値: iphone | ipad | android | blackberry

デフォルト:すべてのデバイスを許可

例:["iphone", "ipad" ]

いいえ
domain_restrictions

ドメイン制限を指定します。 タイプ:コンテナ

 
domains

複数のドメインをホワイトリストもしくはブラックリストのどちらに載せるかを指定します。

タイプ:文字列の配列

条件:domain_restrictionsが指定された場合、必須。

例:["example.com", "myotherdomain.com"]

親: domain_restrictions

条件付き
enabled Ooyala再生トークンが必要かどうかを有効/無効にします。

タイプ: 文字列

有効値 true | false

例:

"secure_playback_token": {
                  "enabled": "true"
                  }
                
親: secure_playback_token
いいえ
end_date

時間制限の終了時間を指定します。

タイプ:DateTime

有効値:DateTime | null

条件:time_restrictionsが指定された場合、必須。

例:"2010-01-01T00:00:00Z"

親: time_restrictions

条件付き
end_time

コンテンツの視聴可能終了時刻を指定します。

タイプ:時間

条件:タイプが"recurring"でall_dayが指定されていない、またはfalseに設定されている場合、必須。

例:"23:59:59"

親: time_restrictions

条件付き
expiration Ooyala再生トークンの有効期限が切れる前の秒単位の時間

タイプ: 整数

親: secure_playback_token

 
geographic_restrictions

特定の地域を指定します。 タイプ:コンテナ

 
limit_devices_per_viewer 視聴者が登録できるデバイス数に制限を設けます。プレイヤーデバイス管理と 連動して機能します。

タイプ:文字列

有効値: true | false

 
locations

1文字または2文字で表される地域コードをホワイトリストまたはブラックリストに載せるかを指定する配列。

タイプ:文字列

有効値:国コードと場所コードをご覧ください。

条件:geographic_restrictionsが指定された場合、必須。

例:["US", "EU"]

親: geographic_restrictions

条件付き
name

発行ルールの名前を指定します。

タイプ:文字列

例:"My Rule"

はい
recurring_days

有効な曜日を指定します。

タイプ:文字列の配列

有効値:"MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "SUN"

条件:タイプが"recurring"に設定されている場合、必須。

例:["MON", "WED", "FRI"]

親: time_restrictions

条件付き
require_user_entitlement アセットへのアクセス権をユーザーに求めるか否か。Rights Lockerを有効にします。

タイプ:文字列

有効値: true | false

例:

"secure_playback_token": {
                  "require_user_entitlement": "true"
                  }
                

親: secure_playback_token

いいえ
restrict_concurrent_streams 同時ストリーム数に制限を設けるか否か。プレイヤー承認 APIを有効にします。

タイプ:文字列

有効値: true | false

例:

"secure_playback_token": {
                  "restrict_concurrent_streams": "true"
                  }
                

親: secure_playback_token

いいえ
secure_playback_token Ooyalaプレイヤートークンを通じて再生するためにユーザー認証が必要が どうかに関連したプロパティ

タイプ:コンテナ

いいえ
start_date

時間制限の開始時間を指定します。

タイプ:DateTime

有効値:DateTime | null

条件:time_restrictionsが指定された場合、必須。

例:"2010-01-01T00:00:00Z"

親: time_restrictions

条件付き
start_time

コンテンツの視聴可能開始時刻を指定します。

タイプ:時間

条件:タイプが"recurring"でall_dayが指定されていない、またはfalseに設定されている場合、必須。

例:"20:00:00"

親: time_restrictions

条件付き
time_restrictions 時間制限を指定します。タイプ:コンテナ  
type

特定の地域をホワイトリストもしくはブラックリストのどちらに載せるかを指定します。

タイプ:文字列

有効値: whitelist | blacklist

条件:geographic_restrictionsが指定された場合、必須。

例:"whitelist"

親: geographic_restrictions

条件付き
type

ドメインをホワイトリストもしくはブラックリストのどちらに載せるかを指定します。

タイプ:文字列

有効値: whitelist | blacklist

条件:domain_restrictionsが指定された場合、必須。

例:"whitelist"

親: domain_restrictions

条件付き
type

これが繰り返しなのか一度限りの時間制限なのかを指定します。

タイプ:文字列

有効値: range | recurring

条件:time_restrictionsが指定された場合、必須。

例:"range"

親: time_restrictions

条件付き

この例は制限なしの基本的な発行ルールを作成します。

 [POST] /v2/publishing_rules
{
  "name": "My Basic Publishing Rule"
}
    

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

{
  "name": "My Basic Publishing Rule",
  "allowed_devices": [
    "iphone",
    "ipad",
    "android",
   "blackberry"
  ],
  "time_restrictions": {
    "start_date": null,
    "type": "range",
    "end_date": null
  },
  "domain_restrictions": {
    "domains": [

    ],
    "type": "blacklist"
  },
  "geographic_restrictions": {
    "type": "blacklist",
    "locations": [

    ]
  },
  "id": "9b70a34a678346b185f9b81c7a291d8b"
}
    

Sorting 試行する

この例はコンテンツの埋め込みをmywebsite.comにのみ許可し、USまたはEUでのみ視聴可能に なるように発行ルールを修正します。

[POST] /v2/publishing_rules/9b70a34a678346b185f9b81c7a291d8b
    {
      "domain_restrictions": {
        "domains": [
          "mywebsite.com"
        ],
        "type": "whitelist"
      },
      "geographic_restrictions": {
        "type": "whitelist",
        "locations": [
          "US",
          "EU"
        ]
      }
    }
    

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

{
  "name": "My Publishing Rule",
  "allowed_devices": [

  ],
  "time_restrictions": {
    "start_date": "2007-04-05T00:00:00+00:00",
    "type": "range",
    "end_date": null
  },
  "domain_restrictions": {
    "domains": [
      "mywebsite.com"
    ],
    "type": "whitelist"
  },
  "geographic_restrictions": {
    "type": "whitelist",
    "locations": [
      "US",
      "EU"
    ]
  },
  "id": "79feefbe24d9424786d53b5edffb4b94"
}
    

Sorting 試行する

この例はすべての発行ルールを一覧表示します。

[GET] /v2/publishing_rules
    

Backlot すべての発行ルールにコンフィギュレーション設定を返します。

この例は指定された発行ルールに関する情報を返します。

[GET] /v2/publishing_rules/79feefbe24d9424786d53b5edffb4b94
    

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

{
  "name": "My Publishing Rule",
  "allowed_devices": [

  ],
  "time_restrictions": {
    "start_date": "2007-04-05T00:00:00+00:00",
    "type": "range",
    "end_date": null
  },
  "domain_restrictions": {
    "domains": [
      "mywebsite.com"
    ],
    "type": "whitelist"
  },
  "geographic_restrictions": {
    "type": "whitelist",
    "locations": [
      "US",
      "EU"
    ]
  },
  "id": "79feefbe24d9424786d53b5edffb4b94"
}
    

Sorting 試行する

この例はラベルを削除します。

[DELETE] /v2/publishing_rules/79feefbe24d9424786d53b5edffb4b94
    

Backlot は200のレスポンスを返します。

Sorting 試行する

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