文档中心 > API类目 > 用户增长

taobao.usergrowth.ad.material.audit (素材审核)

素材审核

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
biz_type Number 必须 1 投放场景
scenario_type Number 必须 1 素材卖点
outer_creative_id String 必须 123 创意id
title String 可选 长文案 长文案
img_url String 可选 https://xx.taobao.com/image.jpg 图片url
h5_url String 可选 https://m.taobao.com/tbopen/index.html?action=ali.open.nav H5落地页链接
ad_type Number 必须 1 广告类型1 线上硬广;2 达人私域;3 线下;4 厂商生态
video_url String 可选 https://xx.taobao.com/video.mp4 视频url
sub_title String 可选 短文案 短文案
creative_type Number 必须 1 创意类型,1 图片;2 视频
dp_url String 可选 tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav dp链接
app_id Number 必须 1 应用id 1 手淘
channel_id Number 必须 123456 渠道id
task_id Number 必须 123456 任务id
hot_event Number 必须 0 热点事件
specific_file_name String 可选 测试文件名-1-1231321 格式为:自定义名称-序号-商品id
biz_type_v2 String 可选 承接信息 格式为:pool_12221,即pool_ + 商品库id

响应参数

名称 类型 示例值 描述
response_code Number 6 参数错误
data Number 123 新增创意id
message String 参数错误 错误信息
successful Boolean true 请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UsergrowthAdMaterialAuditRequest req = new UsergrowthAdMaterialAuditRequest();
req.setBizType(1L);
req.setScenarioType(1L);
req.setOuterCreativeId("123");
req.setTitle("长文案");
req.setImgUrl("https://xx.taobao.com/image.jpg");
req.setH5Url("https://m.taobao.com/tbopen/index.html?action=ali.open.nav");
req.setAdType(1L);
req.setVideoUrl("https://xx.taobao.com/video.mp4");
req.setSubTitle("短文案");
req.setCreativeType(1L);
req.setDpUrl("tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav");
req.setAppId(1L);
req.setChannelId(123456L);
req.setTaskId(123456L);
req.setHotEvent(0L);
req.setSpecificFileName("测试文件名-1-1231321");
req.setBizTypeV2("承接信息");
UsergrowthAdMaterialAuditResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<usergrowth_ad_material_audit_response>
    <response_code>6</response_code>
    <data>123</data>
    <message>参数错误</message>
    <successful>true</successful>
</usergrowth_ad_material_audit_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部