广告位资源相关API

广告位资源相关API

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


1.广告位列表

接口:adlocation/list

请求字段:

名称 类型 描述
page int 可以为空,默认值1
size int 可以为空,默认值50,最大50

接口返回:

名称 类型 描述
ret_code int 返回码
ret_msg 对象类型 返回内容
error_code int 错误补充码

ret_msg内容详细:

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

records内容详细:

名称 类型 描述
location_id string 广告位ID
location_name string 广告位名称
media_plat string 媒体平台
memo string 广告位说明
update_time string 更新时间
block_vocation string 禁播行业 GPB无
cpm_start_price string CPM底价(¥) GPB无
dsp_status string DSP侧开启状态 GPB无

请求示例:

返回示例:

2.广告位资源详细

接口:adlocation/detail

请求字段:

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

data内容详细:

名称 类型 描述
location_id string 广告位ID

接口返回:

名称 类型 描述
ret_code int 返回码
ret_msg 数组类型 返回内容
error_code int 错误补充码

ret_msg内容详细:

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

display_data内容详细:

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

baseinfo内容详细:

名称 类型 描述
display_id int 广告形式id
display_name string 广告形式名称
duration string 视频时长(贴片才有)
show_style string 展示形式
platform string 设备平台
click_area string 点击区域
open_type string 打开方式
memo string 备注

sizeinfo内容详细:

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

size_data内容详细:

名称 类型 描述
desc string 素材说明
fodder string 素材规范
suffix string 素材类型
size string 素材大小

请求示例:

返回示例: