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