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

Intelligent Media Services:ListAdInsertions

最終更新日:Mar 21, 2026

広告インサーション構成を取得します。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:ListAdInsertions

list

*All Resource

*

なし なし

リクエスト構文

GET  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

Keyword

string

任意

構成名。あいまい一致がサポートされています。

ad

PageNo

integer

任意

ページ番号。デフォルト値:1。

1

PageSize

integer

任意

1ページあたりのエントリ数。デフォルト値:10。

10

SortBy

string

任意

作成時間による構成のソート順。asc:昇順。desc:降順。

列挙値:

  • asc :
  • desc :

asc

NextToken

string

任意

次のリクエストで新しい結果ページを取得するために使用されるトークン。このパラメーターを使用すると、ページネーションパラメーターは無効になります。

******8EqYpQbZ6Eh7+Zz8DxVYoQ*****

MaxResults

integer

任意

後続のリクエストで取得するエントリの最大数。このパラメーターを使用すると、ページネーションパラメーターは無効になります。デフォルト値:10。

10

レスポンスフィールド

フィールド

説明

object

応答のスキーマ

Configs

array<object>

配列

array<object>

AdInsertionConifgItemType

CreateTime

string

構成が作成された時間。

2024-06-13T08:26:09Z

LastModified

string

構成が最後に変更された時間。

2024-06-13T08:26:09Z

Name

string

広告インサーション構成の名前。

my_ad

ContentUrlPrefix

string

ソースコンテンツの URL プレフィックス。

https://source.com/

AdsUrl

string

広告決定サーバー (ADS) のリクエスト 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/

PageNo

integer

ページ番号。

1

PageSize

integer

1ページあたりのエントリ数。

10

RequestId

string

リクエスト ID。

******11-DB8D-4A9A-875B-275798******

SortBy

string

作成時間による構成のソート順。asc:昇順。desc:降順。

asc

TotalCount

integer

返されたエントリの総数。

10

NextToken

string

次のリクエストで新しい結果ページを取得するために使用されるトークン。このパラメーターを使用すると、ページネーションパラメーターは無効になります。

******8EqYpQbZ6Eh7+Zz8DxVYoQ*****

MaxResults

integer

後続のリクエストで取得するエントリの最大数。このパラメーターを使用すると、ページネーションパラメーターは無効になります。

10

成功レスポンス

JSONJSON

{
  "Configs": [
    {
      "CreateTime": "2024-06-13T08:26:09Z",
      "LastModified": "2024-06-13T08:26:09Z\n",
      "Name": "my_ad",
      "ContentUrlPrefix": "https://source.com/",
      "AdsUrl": "http://ads.com/ad1?param1=[palyer_params.p1]",
      "ConfigAliases": "{\n      \"player_params.p1\": {\n            \"1\": \"abc\"\n      }\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/"
      }
    }
  ],
  "PageNo": 1,
  "PageSize": 10,
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "SortBy": "asc",
  "TotalCount": 10,
  "NextToken": "******8EqYpQbZ6Eh7+Zz8DxVYoQ*****",
  "MaxResults": 10
}

エラーコード

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

変更履歴

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