查詢廣告插入配置 - 智能媒體服務 IMS

擷取廣告插入配置列表。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:ListAdInsertions

list

*全部資源

*

無

請求文法

GET  HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
Keyword	string	否	按廣告配置名稱查詢，支援模糊比對	ad
PageNo	integer	否	分頁參數，頁碼，預設為 1	1
PageSize	integer	否	分頁參數，頁寬，預設為 10	10
SortBy	string	否	分頁參數，排序方式，asc:按建立時間升序，desc:按建立時間降序枚舉值： asc : 按建立時間升序 desc : 按建立時間降序	asc
NextToken	string	否	資料抓取參數，擷取後續資料的 token，使用此方式擷取資料時分頁參數將無效	****8EqYpQbZ6Eh7+Zz8DxVYoQ***
MaxResults	integer	否	資料抓取參數，擷取後續資料的最大記錄數，使用此方式擷取資料時分頁參數將無效，預設為 10	10

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
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	廣告策略伺服器 URL	http://ads.com/ad1?param1=[palyer_params.p1]
ConfigAliases	string	動態配置別名	{ "player_params.p1": { "1": "abc" } }
PersonalizationThreshold	integer	個人化配置閾值	5
SlateAdUrl	string	slate 廣告 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	分頁參數，頁寬	10
RequestId	string	Id of the request	****11-DB8D-4A9A-875B-275798****
SortBy	string	分頁參數，排序方式，asc:按建立時間升序，desc:按建立時間降序	asc
TotalCount	integer	總記錄數	10
NextToken	string	資料抓取參數，擷取後續資料的 token，使用此方式擷取資料時分頁參數將無效	****8EqYpQbZ6Eh7+Zz8DxVYoQ***
MaxResults	integer	資料抓取參數，擷取後續資料的最大記錄數，使用此方式擷取資料時分頁參數將無效	10

樣本

正常返回樣本

JSON格式

{
  "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
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。