广告创意信息

需要携带 Token,详情看 Token

请求地址

https://scaler.taurusx.com/openapi/creative_info

请求方法

GET

请求参数

字段是否必填字段类型默认值字段说明
campaign_ids选填string-Campaign ID,多个用,隔开
adgroup_ids选填string-Adgroup ID,多个用,隔开
creative_ids选填string-Creative ID,多个用,隔开
page必填int1当前请求的页数,为大于等于 1 的整数
page_size必填int50每次请求的数量,最大为 100

注意

当需要按批次处理返回结果时,可以在请求头中携带 batch-id 字段,格式为时间戳或者 MD5 字符串等不重复字符串即可。

响应结果

名称父节点类型描述
codeint200 表示成功,其他表示失败
datajson结果列表
data_listdataarray<json>
campaign_namedata_liststring推广名称
campaign_iddata_liststringCampaign ID
adgroup_namedata_liststring广告组名称
adgroup_iddata_liststringAdgroup ID
creative_namedata_liststring素材名称
creative_iddata_liststringCreative ID
ad_typedata_liststring素材类型:video 视频,image 图片
infodata_listjson素材信息
typeinfostring素材类型,image|video
winfoint素材宽度
hinfoint素材高度
bit_rateinfonumber视频比特率,视频素材有此字段
durationinfonumber视频时长,单位秒,视频素材有此字段
companiondata_listjson伴随广告信息
typecompanionstring素材类型,image
wcompanionint素材宽度
hcompanionint素材高度

响应结果示例

JSON
{
    "code": 200,
    "data": {
        "data_list": [
            {
                "campaign_id": 138,
                "campaign_name": "name",
              	"adgroup_id": 138,
                "adgroup_name": "name",
                "creative_id": 138,
                "creative_name": "电商大促",
                "ad_type": "video",
                "info": {
                    "type": "video",
                    "bit_rate": 1521.651,
                    "duration": 29.68,
                    "w": 1280,
                    "h": 720
                },
                "companion": {
                    "type": "image",
                    "w": 704,
                    "h": 396
                }
            }
        ],
        "total": 1
    },
    "msg": "ok"
}
{
    "code": 200,
    "data": {
        "data_list": [
            {
                "campaign_id": 138,
                "campaign_name": "name",
              	"adgroup_id": 138,
                "adgroup_name": "name",
                "creative_id": 138,
                "creative_name": "电商大促",
                "ad_type": "video",
                "info": {
                    "type": "video",
                    "bit_rate": 1521.651,
                    "duration": 29.68,
                    "w": 1280,
                    "h": 720
                },
                "companion": {
                    "type": "image",
                    "w": 704,
                    "h": 396
                }
            }
        ],
        "total": 1
    },
    "msg": "ok"
}