跳到主要内容

广告位资源相关 API

功能描述:DSP 上传素材前,可以先通过查询接口获取可用广告位、广告形式的状态信息。包括广告位列表接口和广告位资源详细接口。

1. 广告位列表​

接口:adlocation/list

请求字段:

名称类型描述
pageint可以为空,默认值1
sizeint可以为空,默认值50,最大50

接口返回:

名称类型描述
ret_codeint返回码
ret_msg对象类型返回内容
error_codeint错误补充码

ret_msg 内容详细:

名称类型描述
totalint总记录数
records数组类型列表

records 内容详细:

名称类型描述
location_idstring广告位ID
location_namestring广告位名称
media_platstring媒体平台
memostring广告位说明
update_timestring更新时间
block_vocationstring禁播行业 GPB 无
cpm_start_pricestringCPM 底价(¥),GPB 无
dsp_statusstringDSP 侧开启状态 GPB 无

请求示例:

广告位列表请求示例

返回示例:

广告位列表返回示例

2. 广告位资源详细​

接口:adlocation/detail

请求字段:

名称类型描述
data数组类型最多10个

data 内容详细:

名称类型描述
location_idstring广告位ID

接口返回:

名称类型描述
ret_codeint返回码
ret_msg数组类型返回内容
error_codeint错误补充码

ret_msg 内容详细:

名称类型描述
location_idstring广告位ID
location_namestring广告位名称
display_data数组类型播放形式基本信息

display_data 内容详细:

名称类型描述
baseinfo对象类型广告形式基本信息
sizeinfo对象类型创意素材规范信息

baseinfo 内容详细:

名称类型描述
display_idint广告形式ID
display_namestring广告形式名称
durationstring视频时长(贴片才有)
show_stylestring展示形式
platformstring设备平台
click_areastring点击区域
open_typestring打开方式
memostring备注

sizeinfo 内容详细:

名称类型描述
file_countint素材个数
size_data数组类型具体格式定义

size_data 内容详细:

名称类型描述
descstring素材说明
fodderstring素材规范
suffixstring素材类型
sizestring素材大小

请求示例:

广告位资源详细请求示例

返回示例:

广告位资源详细返回示例