广告位资源相关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 | 素材大小 |
请求示例:
返回示例: