文档中心 > API类目 > miniapp开放API

taobao.miniapp.distribution.material.create (小程序投放--新建投放素材)

为可投放的小程序,增加入口的素材信息,比如图片、引导文案等等。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
material_request MiniAppEntranceMaterialBizOpenDTO 必须 投放入口素材信息
  • └ data_str
  • String
  • 必须
  • {"a":"b"}
  • 场景入口对应的素材动态表单值,必须符合表单的要求。每个场景、入口卡片都拥有不同的限制,请通过开发者控制台查看具体的表单字段要求。如果没有任何参数值,请传入空map
  • └ p_params_value_str
  • String
  • 必须
  • {"c":"c1"}
  • 对应页面的页面参数值map,如果没有任何参数值,请传入空map
  • └ path
  • String
  • 必须
  • pages/index
  • 当前素材,对应的页面路径。必须为已经在开发者控制台-页面录入菜单下,已经录入过的页面路径之一。
  • └ q_params_value_str
  • String
  • 必须
  • {"d":"d1"}
  • 对应页面的全局参数值map,如果没有任何参数值,请传入空map
  • └ app_id
  • Number
  • 必须
  • 300002222222
  • 对应的可投放的小程序id
  • └ card_id
  • Number
  • 必须
  • 22
  • 素材适用的入口样式卡片id
  • └ name
  • String
  • 必须
  • 测试默认素材
  • 素材的名字,主要用于方便商家辨识素材
  • └ scene_id
  • Number
  • 必须
  • 16
  • 素材适用的入口场景id

响应参数

名称 类型 示例值 描述
material_success Boolean true 调用是否成功
material_error_code String 1000 错误码
model Number 1 创建成功的素材id
material_error_message String 创建失败 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
MiniappDistributionMaterialCreateRequest req = new MiniappDistributionMaterialCreateRequest();
MiniappDistributionMaterialCreateRequest.MiniAppEntranceMaterialBizOpenDTO obj1 = new MiniappDistributionMaterialCreateRequest.MiniAppEntranceMaterialBizOpenDTO();
obj1.setDataStr("{\"a\":\"b\"}");
obj1.setPParamsValueStr("{\"c\":\"c1\"}");
obj1.setPath("pages/index");
obj1.setQParamsValueStr("{\"d\":\"d1\"}");
obj1.setAppId(300002222222L);
obj1.setCardId(22L);
obj1.setName("测试默认素材");
obj1.setSceneId(16L);
req.setMaterialRequest(obj1);
MiniappDistributionMaterialCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<miniapp_distribution_material_create_response>
    <material_success>true</material_success>
    <material_error_code>1000</material_error_code>
    <model>1</model>
    <material_error_message>创建失败</material_error_message>
</miniapp_distribution_material_create_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

返回
顶部