王尘宇

华为广告推广查询创意

通过此接口可以查询创意

请求地址

https://ads.cloud.huawei.com/openapi/v2/promotion/creative/query

请求方法

GET

请求参数

参数名称	类型	是否必选	描述
page_num	integer	是	搜索页码 取值范围 1~10000
page_size	integer	是	一页展示数量 取值范围 10~50
以下为过滤字段
adgroup_id	long	否	任务 ID
creative_id	long	否	创意 ID
approved_status	string	否	创意审核状态 详见【创意审核状态】
updated_begin_time	string	否	计划更新的开始时间，格  式:"yyyy-MM-dd HH:mm:ss"
updated_end_time	string	否	计划更新的开始时间，格  式:"yyyy-MM-dd HH:mm:ss"

请求示例

=================================================================== ======================================

GET openapi/v2/promotion/creative/query?page_size=51&page_num=1&creative_id=XXX

HTTP/1. 1

Accept:application/json

Content-Type:application/json

Authorization:Bearer                                                                                                                          CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=

=================================================================== ======================================

响应字段

参数名称	类型	是否必选	描述
code	string	是	返回码
message	string	否	返回描述
data	Struct1	否	创意列表

Struct1 定义

参数名称	类型	是否必选	描述
total	integer	是	创意总条数
data	Struct2[]	否	创意列表

Struct2 定义

参数名称	类型	是否必选	描述
approval_status	string	是	创意审核状态 详见【创意审核状态】
show_status	string	是	创意显示状态 详见【创意显示状态】
creative_id	long	是	创意 ID
campaign_id	string	是	推广计划 ID
adgroup_id	long	是	任务 ID
creative_name	string	是	创意名称
creative_size_type	string	是	版位形式 详见【版位形式】
creative_size_sub_type	string	是	版位子形式

			详见【版位子形式】
creative_size_id	long	是	版位 ID
creative_status	string	是	操作状态 详见【计划/任务/创意操作状 态】
approved_message	string	否	审核信息
dyn_ad_text_flag	string	否	动态词包标识 详见【动态词包标识】
content_struct	Struct3	是	创意详情
creative_score	integer	否		创意打分字段
creative_comment	string	否		评分意见

Struct3 定义

参数名称	类型	是否必选	描述
images	Struct4[]	否	图片列表信息
icon	Struct4	否	icon 信息
video	Struct4	否	视频信息
title	Struct5	否	文案
description	Struct5	否	描述
corporate	Struct5	否	品牌名称
landing_page	Struc6	否	落地页信息
deeplink	Struct7	否	应用直达地址
impression_monitor_url	Struct8	否	展示监控地址 详见【约束地址】
click_monitor_url	Struct8	否	点击监控地址 详见【约束地址】

Struct4 定义

参数名称	类型	是否必选	描述
file	Struct9	是	素材

Struct9 定义

参数名称	类型	是否必选	描述
url	string	是	素材地址
width	integer	是	宽度，单位像素
height	integer	是	高度，单位像素
format	string	是	后缀名 video/mp4 image/jpg image/jpeg image/png image/gif
size	integer	是	文件大小
asset_id	long	是	资产 ID
sha256	string	是	文件 sha256 摘要
md5	string	是	文件 md5 摘要
duration	integer	否	视频播放时长，仅视频存在， 单 位毫秒

Struct5 定义

参数名称	类型	是否必选	描述
text	string	是	内容

Struct6 定义

参数名称	类型	是否必选	描述
landing_page	string	是	落地页地址

Struct7 定义

参数名称	类型	是否必选	描述
deeplink	string	否	应用直达地址信息

Struct8 定义

参数名称	类型	是否必选	描述
monitor_url	string	是	展示监控地址

应答示例

=================================================================== ======================================

HTTPS/1. 1 200 OK

{

"code": "200",

"data": {

"total": 1,

"data": [{

"creative_name": "zyh123123",

"content_struct": {

"images": [{

"sequence": 1,

"file": {

"duration": 0,

"size": 151947,

"sha256": "0a2f186b68582a1f119d32f574284e6ff124ca1177826d51edb75d8b4c3f474d", "width": 1080,

"format": "image/jpeg",

"url": "https://cs02-pps-

drcn.dbankcdn.com/dl/pps/20191212153725fbed5339f827488487249895f53ec3eb.jpg", "file_url_with_sites": [],

"height": 607,

"md5": "72d52e372d767c5d780078cfd7a21ecc"

},

"id": 10000056

}],

"corporate": {

"id": 10000025,

"text": "沃尔沃汽车"

 

},

"deeplink": {

"deeplink":

"himovie://com.huawei.himovie/showlive?channelId=L201912091534416000002011300000 0&pver=21300000&portal=himovie&from=himovie ?",

"id": 10000001

},

"landing_page": {

"landing_page": "https://url.cloud.huawei.com/50XtmcwvEk",

"id": 10000003,

"landing_page_type": 3,

"need_show_title": false

},

"title": {

"id": 10000006,

"text": "沃尔沃全新 S60  上市发布会"

}

},

"adgroup_id": 1,

"approved_status": "APPROVE",

"dyn_ad_text_flag": "DYNAMIC_WORD_DISABLE",

"creative_id": 1,

"creative_size_id": 42,

"creative_size_sub_type": "SPLASH_PICTURE",

"approved_message": "涉嫌违法问题， 请整改",

"show_status": "CREATIVE_STATUS_ENABLE",

"creative_status": "OPERATION_STATUS_ENABLE",

"campaign_id": "1",

"creative_size_type": "CREATIVE_SIZE_TYPE_SINGLE_PICTURE"

}]

}

}

=================================================================== ======================================

---