広告挿入構成を追加します。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Name |
string |
必須 |
構成の名前。名前は同じアカウント内で一意である必要があります。長さは最大 128 文字で、正規表現 [A-Za-z0-9_-]+ に一致する必要があります。 |
my_ad |
| ClientToken |
string |
任意 |
べき等性を確保するために使用されるクライアントトークン。重複送信を防ぐため、トークンは各リクエストで一意である必要があります。長さは最大 200 文字です。 |
****0311a423d11a5f7dee713535**** |
| ContentUrlPrefix |
string |
必須 |
コンテンツ URL のプレフィックス。URL は HTTP および HTTPS プロトコルをサポートします。長さは最大 512 文字です。 |
https://source.com/ |
| SlateAdUrl |
string |
任意 |
スレート広告の URL。URL は HTTP および HTTPS プロトコルをサポートし、MP4 ファイル (.mp4) のみに対応します。長さは最大 2,048 文字です。 |
http://storage.com/slate1.mp4 |
| ConfigAliases |
string |
任意 |
動的構成エイリアス。値は JSON 文字列です。player_params.{name} エントリは最大 20 個まで追加できます。name 部分は最大 150 文字です。各 player_params.xxx の下に、最大 50 個のキーと値のペアを追加できます。キーは最大 150 文字、値は最大 500 文字です。例: { "player_params.{name}": { "{key}": "{value}" } } |
{ "player_params.p1": { "1": "abc" } } |
| CdnContentSegmentUrlPrefix |
string |
任意 |
ビデオコンテンツセグメント数用 CDN プレフィックス。URL は HTTP および HTTPS プロトコルをサポートします。長さは最大 512 文字です。 |
http://cdn.com/ |
| CdnAdSegmentUrlPrefix |
string |
任意 |
広告セグメント数用 CDN プレフィックス。URL は HTTP および HTTPS プロトコルをサポートします。長さは最大 512 文字です。 |
http://cdn.com/ |
| AdMarkerPassthrough |
string |
任意 |
広告マーカーをパススルーするかどうかを指定します。デフォルト値: OFF。 列挙値:
|
ON |
| PersonalizationThreshold |
integer |
任意 |
パーソナライゼーションしきい値。単位: 秒。デフォルト値: 8。 |
5 |
| AdsUrl |
string |
必須 |
広告決定サーバーの URL。URL は HTTP および HTTPS プロトコルをサポートします。長さは最大 2,048 文字です。 |
http://ads.com/ad1?param1=[palyer_params.p1] |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマ。 |
||
| Config |
object |
広告挿入構成。 |
|
| CreateTime |
string |
構成が作成された時間。時間は ISO 8601 標準に従い、協定世界時 (UTC) (Z で終わる) です。 |
2024-06-13T08:26:09Z |
| LastModified |
string |
構成が最後に変更済みになった時間。 |
2024-06-13T08:26:09Z |
| Name |
string |
広告挿入構成の名前。 |
my_ad |
| ContentUrlPrefix |
string |
コンテンツ URL のプレフィックス。 |
https://source.com/ |
| AdsUrl |
string |
広告決定サーバーの URL。 |
http://ads.com/ad1?param1=[palyer_params.p1] |
| ConfigAliases |
string |
動的構成エイリアス。 |
{ "player_params.p1": { "1": "abc" } } |
| PersonalizationThreshold |
integer |
パーソナライゼーションしきい値。 |
5 |
| SlateAdUrl |
string |
スレート広告の URL。 |
http://storage.com/slate1.mp4 |
| CdnConfig |
object |
CDN 構成。 |
|
| ContentSegmentUrlPrefix |
string |
ビデオコンテンツセグメント数用 CDN プレフィックス。 |
http://cdn.com/ |
| AdSegmentUrlPrefix |
string |
広告セグメント数用 CDN プレフィックス。 |
http://cdn.com/ |
| AdMarkerPassthrough |
string |
広告マーカーがパススルーされるかどうかを示します。 |
ON |
| ManifestEndpointConfig |
object |
マニフェストエンドポイント構成。 |
|
| HlsPrefix |
string |
HLS マニフェストエンドポイントプレフィックス。 |
https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/master/****4fda5b1a8e0d46c9bf6262a7****/my_ad/ |
| DashPrefix |
string |
DASH マニフェストエンドポイントプレフィックス。 |
https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/dash/****4fda5b1a8e0d46c9bf6262a7****/my_ad/ |
| RequestId |
string |
リクエスト ID。 |
******3B-0E1A-586A-AC29-742247****** |
例
成功レスポンス
JSONJSON
{
"Config": {
"CreateTime": "2024-06-13T08:26:09Z",
"LastModified": "2024-06-13T08:26:09Z\n",
"Name": "my_ad",
"ContentUrlPrefix": "https://source.com/\n",
"AdsUrl": "http://ads.com/ad1?param1=[palyer_params.p1]\n",
"ConfigAliases": "{ \"player_params.p1\": { \"1\": \"abc\" } }\n",
"PersonalizationThreshold": 5,
"SlateAdUrl": "http://storage.com/slate1.mp4\n",
"CdnConfig": {
"ContentSegmentUrlPrefix": "http://cdn.com/\n",
"AdSegmentUrlPrefix": "http://cdn.com/\n"
},
"AdMarkerPassthrough": "ON",
"ManifestEndpointConfig": {
"HlsPrefix": "https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/master/****4fda5b1a8e0d46c9bf6262a7****/my_ad/\n",
"DashPrefix": "https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/dash/****4fda5b1a8e0d46c9bf6262a7****/my_ad/"
}
},
"RequestId": "******3B-0E1A-586A-AC29-742247******"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。