获取广告单元素材组
需要携带 Token,详情看 Token
获取创意组信息, 支持按条件分页查询
请求地址
https://ss-api.mintegral.com/api/open/v1/creative_sets
请求方法
GET
请求示例
json
GET /api/open/v1/creative_sets
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ "offer_id": 3028 }
请求参数
字段 | 类型 | 是否必填 | 说明 | 默认值 | 例子 |
---|---|---|---|---|---|
offer_id | int | N | 广告单元ID | — | 123 |
creative_set_id | int | N | 创意组ID | — | 123 |
creative_set_name | string | N | 创意组名称 | — | set_name1 |
combination_method | int | N | 创意制作方式 | - | set_name1 |
page | int | N | 分页, 从1开始 | 1 | 1 |
limit | int | N | 分页每页记录数,默认10,最大50 | 10 | 20 |
响应结果
字段 | 类型 | 说明 |
---|---|---|
code | int | 200 表示成功,其他表示失败 |
msg | string | 成功,返回"success",失败返回相应的错误信息 |
data | json | 成功,返回素材组信息,失败返回具体的错误信息 |
limit | int | 数据页记录数上限 |
page | int | 数据页 |
total | int | 总记录数 |
list | array<object> | 记录详情 |
offer_id | int | 广告单元ID |
creative_set_name | string | 创意组名称 |
combination_method | int | 创意组创意组装方式 |
ad_outputs | array<int> | [枚举值 - 创意类型类型及要求尺寸] |
geos | array<string> | 投放地区 |
creatives | array<object> | 创意组包含素材详情 |
creative_name | string | 素材名称 |
creative_md5 | string | 素材md5 |
creative_type | string | 素材类型 |
dimension | string | 素材尺寸 |
created_at | int | 素材绑定到创意组的时间 |
audit_status | int | 素材审核状态, 0为初始化,1为通过,2为拒审,3为审核中 |
audit_reason | string | 素材拒审原因 |
应答示例
json
{
"msg": "success",
"code": 200,
"data": {
"limit": 10,
"page": 1,
"total": 1,
"list": [
{
"offer_id": 100,
"creative_set_name": "test_group_1",
"combination_method": 1,
"ad_outputs": [
111,
121,
131
],
"geos": [
"ALL"
],
"creatives": [
{
"creative_name": "image_1.jpg",
"creative_md5": "4066f7e9738eb0cfe87f59e752f8d64f",
"creative_type": "IMAGE",
"dimension": "1200x627",
"created_at": 1714124002,
"audit_status": 1,
"audit_reason": ""
},
{
"creative_name": "image_2.jpg",
"creative_md5": "9d4af767418b5e20a936c7c07f017e39",
"creative_type": "IMAGE",
"dimension": "1200x627",
"created_at": 1714124002,
"audit_status": 1,
"audit_reason": ""
},
{
"creative_name": "video_1.jpg",
"creative_md5": "9d4af767418b5e20a936c7c07f017e39",
"creative_type": "VIDEO",
"dimension": "1280x720",
"created_at": 1714124002,
"audit_status": 1,
"audit_reason": ""
}
]
}
]
}
}