すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Services:UpdateAdInsertion

最終更新日:Oct 12, 2026

広告挿入構成を更新します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

Name

string

必須

構成の名前。このパラメーターは変更済みにはできません。

my_ad

ContentUrlPrefix

string

必須

コンテンツ URL のプレフィックス。HTTP および HTTPS プロトコルがサポートされています。最大値は 512 文字です。

https://source.com/

SlateAdUrl

string

任意

スレート広告の 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 プレフィックス。HTTP および HTTPS プロトコルがサポートされています。最大値は 512 文字です。

http://cdn.com/

CdnAdSegmentUrlPrefix

string

任意

広告セグメント数の CDN プレフィックス。HTTP および HTTPS プロトコルがサポートされています。最大値は 512 文字です。

http://cdn.com/

AdMarkerPassthrough

string

任意

広告マーカーをパススルーするかどうかを指定します。有効な値: ON、OFF。デフォルト値: OFF。

列挙値:

  • OFF :

    無効。

  • ON :

    有効。

ON

PersonalizationThreshold

integer

任意

パーソナライゼーション構成のしきい値 (秒単位)。デフォルト値: 8。

5

AdsUrl

string

必須

広告決定サーバーの URL。HTTP および HTTPS プロトコルがサポートされています。最大値は 2,048 文字です。

http://ads.com/ad1?param1=[palyer_params.p1]

レスポンスフィールド

フィールド

型

説明

例

object

応答のスキーマ。

Config

object

広告挿入構成。

CreateTime

string

作成時間。時間は、協定世界時 (UTC) の ISO 8601 フォーマット (末尾が 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。

****63E8B7C7-4812-46AD-0FA56029AC86****

例

成功レスポンス

JSONJSON

{
  "Config": {
    "CreateTime": "2024-06-13T08:26:09Z",
    "LastModified": "2024-06-13T08:26:09Z",
    "Name": "my_ad",
    "ContentUrlPrefix": "https://source.com/",
    "AdsUrl": "http://ads.com/ad1?param1=[palyer_params.p1]",
    "ConfigAliases": "{ \"player_params.p1\": { \"1\": \"abc\" } }\n",
    "PersonalizationThreshold": 5,
    "SlateAdUrl": "http://storage.com/slate1.mp4",
    "CdnConfig": {
      "ContentSegmentUrlPrefix": "http://cdn.com/",
      "AdSegmentUrlPrefix": "http://cdn.com/"
    },
    "AdMarkerPassthrough": "ON",
    "ManifestEndpointConfig": {
      "HlsPrefix": "https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/master/****4fda5b1a8e0d46c9bf6262a7****/my_ad/",
      "DashPrefix": "https://****0311a423d11a5f7dee713535****.weaverpull-ssai.ap-southeast-1.ice.alibabacloudcs.com/v1/dash/****4fda5b1a8e0d46c9bf6262a7****/my_ad/"
    }
  },
  "RequestId": "****63E8B7C7-4812-46AD-0FA56029AC86****"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。