获取元素的预审结果

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主账号 id，直客账号或子客账号
adgroup_id	int64	广告组 id
elements*	struct[]	元素信息的列表数组最小长度 1，最大长度 20
element_type*	enum	元素类型，[枚举详情] 枚举列表：{ IMAGE, VIDEO, TXT, DEST_URL }
element_content*	string	元素内容：1）当元素类型为“图片”时，取值为：image_id 图片 id 2）当元素类型为“视频”时，取值为：video_id 视频 id 3）当元素类型为“文本”时，取值为：文本内容 4）当元素类型为”落地页“时，取值为：落地页的 URL 字段长度最小 0 字节，长度最大 256 字节
element_key	enum	元素 key，[枚举详情] 枚举列表：{ IMG, TXT, CORPORATE_NAME, CORPORATE_IMG, BRAND_CORPORATE_NAME, BRAND_CORPORATE_IMG, BRAND_CORPORATE_DESC, BUTTON_TXT, BUTTON_URL, VIDEO_POPUP_BUTTON_TXT, VIDEO_POPUP_BUTTON_URL, DESC, URL, LEFT_BOTTOM_TXT, BOTTOM_TXT, GIF, VIDEO, LEFT_UPPER_TXT, SHARE_DESC, SHARE_IMG }
supplement	struct[]	补充信息，若此字段不传，或传空则视为无补充信息数组最小长度 1，最大长度 50
field*	string	过滤字段, 可选值：{ adcreative_template_id,mini_program_id,deep_link_url,site_set,campaign_id,is_dynamic_creative }
operator*	enum	操作符当 field 取值 adcreative_template_id 时，枚举列表：{ EQUALS } 当 field 取值 mini_program_id 时，枚举列表：{ EQUALS } 当 field 取值 deep_link_url 时，枚举列表：{ EQUALS } 当 field 取值 site_set 时，枚举列表：{ EQUALS,IN } 当 field 取值 campaign_id 时，枚举列表：{ EQUALS } 当 field 取值 is_dynamic_creative 时，枚举列表：{ EQUALS }
values*	string[]	字段取值 values 数组的个数限制与 operator 的取值相关，详见 [过滤条件] 当 field 取值 mini_program_id 且 operator 取值 EQUALS 时，字段长度最小 1 字节，长度最大 400 字节当 field 取值 deep_link_url 且 operator 取值 EQUALS 时，字段长度最小 1 字节，长度最大 1000 字节当 field 取值 site_set 且 operator 取值 EQUALS 时，枚举列表：{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_KUAISHOU, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_MYAPP, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_YYB, SITE_SET_PENGYOU, SITE_SET_TUAN, SITE_SET_MEISHI, SITE_SET_PIAO, SITE_SET_MAIL, SITE_SET_PC_UNION, SITE_SET_YINGYONGBAO_PC, SITE_SET_PAIPAISEARCH, SITE_SET_QQSHOP, SITE_SET_PAIPAIDAOGOU, SITE_SET_QZONESEARCH, SITE_SET_WEBUNION_DELETED, SITE_SET_EXPRESSPORTAL, SITE_SET_WEIBO, SITE_SET_WANGGOU, SITE_SET_MOBILE_UNION_DELETED, SITE_SET_THIRDPARTY, SITE_SET_JD_WAICAI, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_QQSHOPPING } 当 field 取值 site_set 且 operator 取值 IN 时，枚举列表：{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_KUAISHOU, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_MYAPP, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_YYB, SITE_SET_PENGYOU, SITE_SET_TUAN, SITE_SET_MEISHI, SITE_SET_PIAO, SITE_SET_MAIL, SITE_SET_PC_UNION, SITE_SET_YINGYONGBAO_PC, SITE_SET_PAIPAISEARCH, SITE_SET_QQSHOP, SITE_SET_PAIPAIDAOGOU, SITE_SET_QZONESEARCH, SITE_SET_WEBUNION_DELETED, SITE_SET_EXPRESSPORTAL, SITE_SET_WEIBO, SITE_SET_WANGGOU, SITE_SET_MOBILE_UNION_DELETED, SITE_SET_THIRDPARTY, SITE_SET_JD_WAICAI, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_QQSHOPPING } 当 field 取值 is_dynamic_creative 且 operator 取值 EQUALS 时，枚举列表：{ DYNAMIC_CREATIVE, NOT_DYNAMIC_CREATIVE }

使用说明
1.
获取元素的预审结果。传入的参数越多，预审的结果将更准确。
2.
POST 请求，Content-Type: application/json。
3.
当传入的元素是系统可以立刻给出结果的情况下，接口耗时在毫秒级。
4.
当无法立刻给出结果时，视传入元素的数量和大小等因素影响，接口性能在 ms-40s 之间，具体各种元素类型的平均耗时如下：。
5.
IMAGE 类型，平均耗时 5s，最大耗时 10s。
6.
VIDEO 类型，平均耗时 15s，最大耗时 30s。
7.
TXT 类型，平均耗时 1s，最大耗时 2s。
8.
DEST_URL 类型，平均耗时 1s，最大耗时 2s。

应答字段

名称	类型	描述
list	struct[]	预审结果实体集合
element_type	enum	元素类型，[枚举详情]
element_content	string	元素内容：1）当元素类型为“图片”时，取值为：image_id 图片 id 2）当元素类型为“视频”时，取值为：video_id 视频 id 3）当元素类型为“文本”时，取值为：文本内容 4）当元素类型为”落地页“时，取值为：落地页的 URL
risk_level	enum	元素风险级别，[枚举详情]
pre_review_details	struct[]	元素预审结果明细集合
site_set	enum	投放版位集合，[枚举详情]
pre_review_result	enum	投放版位的预审结果，[枚举详情]
reject_reason_detail	struct[]	拒绝原因明细集合
reject_reason_id	string	拒绝原因 id
reject_reason_content	string	拒绝原因内容
case_doc	string	案例 url
case_content	string	案例内容富文本
reject_info_locations	struct[]	元素拒绝原因详情
x	integer	x 轴位置
y	integer	y 轴位置
width	integer	宽度
height	integer	高度
time_second	float	视频时间点
location_img_url	string	标注结果图 url
img_url	string	帧图片 url
related_img_url	string	种子图 url

curl --location --request POST '/v1.3/review_element_prereview_results/get' \ --header 'access_token;' \ --header 'timestamp;' \ --header 'nonce;' \ --header 'Content-Type: application/json' \ --data-raw '{ "account_id": "<ACCOUNT_ID>", "adgroup_id": "<ADGROUP_ID>", "elements": [], "supplement": [] }'

{ "code": 0, "message": "", "message_cn": "", "data": { "list": [ { "pre_review_details": [ { "reject_reason_detail": [ { "reject_info_locations": [] } ] } ] } ] } }

获取元素的预审结果

请求参数#

应答字段#

请求参数

返回响应

请求参数

应答字段