taobao.picasso.pictag.unit.save.batch (主图打标批量保存投放单元)

批量保存打标投放单元

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
op_type Number 必须 0 操作类型
isv_task_id String 必须 123 任务ID
pic_tag_unit_singles PicTagUnitSingle [] 必须
  • 最大列表长度:999
  • 投放单元信息
    • └ item_major_pic
    • String
    • 可选
    • http://1.jpg
    • 商品主体图片
    • └ item_id
    • Number
    • 可选
    • 1234
    • 商品ID
    • └ isv_template_id
    • String
    • 可选
    • 123
    • isv模板ID
    • └ isv_template_dsl
    • String
    • 可选
    • {xxx}
    • isv模板协议内容
    • dynamic_datas
    • DynamicData []
    • 可选
    • 动态数据
    • └ layer_index
    • String
    • 可选
    • 1
    • 图层index
    • └ data_value
    • String
    • 可选
    • 满200减100
    • 数据值
    • └ data_type
    • String
    • 可选
    • text
    • 数据类型
    • price_rule
    • PictagPriceRuleDto
    • 可选
    • 价格规则
    • └ make_up_num
    • Number
    • 可选
    • 1
    • 选择凑单品时,凑单价数量
    • └ price_express_type
    • Number
    • 可选
    • 3
    • 0:不表达价格,1:表达活动价,2:表达优惠价,3:表达凑单价
    • └ make_up_type
    • Number
    • 可选
    • 1
    • 凑单价类型, 0凑单品, 1跨店满减
    • └ sell_profit_string1
    • String
    • 可选
    • 兜底文案1
    • 商家自己填的利益点1
    • └ sell_profit_string2
    • String
    • 可选
    • 兜底文案2
    • 商家自己填的利益点2
    • └ use_price_rule
    • Boolean
    • 可选
    • true
    • 表达券后价时,商家可以选择展示价格公式,或者商家自己填利益点
    • └ sku_id
    • Number
    • 可选
    • 0
    • 计算价格使用的sku,如果填0将使用最低价sku计算
    • └ merged_pic
    • String
    • 可选
    • http://1.jpg
    • ISV自己合成的图片,task_type=2的自动价格任务不需要传入,task_type=1的普通任务必传
    • └ warnning_materials
    • String []
    • 可选
    • ["1.jpg","2.jpg"]
    • 上报合图用到的违规价格表达素材

    响应参数

    名称 类型 示例值 描述
    result Result 接口返回model
    • └ success
    • Boolean
    • false
    • 是否成功
    • model
    • SaveUnitResult
    • 134523^4351232
    • model
    • fail_detail_list
    • FailDetail []
    • 失败的列表
    • └ err_msg
    • String
    • 排期冲突了
    • 错误原因
    • └ err_code
    • String
    • CONFLICT
    • 错误码
    • └ item_id
    • Number
    • 9
    • 商品ID
    • └ fail_count
    • Number
    • 2
    • 失败的个数
    • └ succcess_ids
    • Number []
    • 处理成功的商品id列表
    • └ success_count
    • Number
    • 8
    • 成功处理的个数
    • └ msg_info
    • String
    • 1
    • msgInfo
    • └ msg_code
    • String
    • 1
    • msgCode

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    PicassoPictagUnitSaveBatchRequest req = new PicassoPictagUnitSaveBatchRequest();
    req.setOpType(0L);
    req.setIsvTaskId("123");
    List<PicassoPictagUnitSaveBatchRequest.PicTagUnitSingle> list2 = new ArrayList<PicassoPictagUnitSaveBatchRequest.PicTagUnitSingle>();
    PicassoPictagUnitSaveBatchRequest.PicTagUnitSingle obj3 = new PicassoPictagUnitSaveBatchRequest.PicTagUnitSingle();
    list2.add(obj3);
    obj3.setItemMajorPic("http://1.jpg");
    obj3.setItemId(1234L);
    obj3.setIsvTemplateId("123");
    obj3.setIsvTemplateDsl("{xxx}");
    List<PicassoPictagUnitSaveBatchRequest.DynamicData> list6 = new ArrayList<PicassoPictagUnitSaveBatchRequest.DynamicData>();
    PicassoPictagUnitSaveBatchRequest.DynamicData obj7 = new PicassoPictagUnitSaveBatchRequest.DynamicData();
    list6.add(obj7);
    obj7.setLayerIndex("1");
    obj7.setDataValue("满200减100");
    obj7.setDataType("text");
    list4.setDynamicDatas(list6);
    PicassoPictagUnitSaveBatchRequest.PictagPriceRuleDto obj9 = new PicassoPictagUnitSaveBatchRequest.PictagPriceRuleDto();
    obj9.setMakeUpNum(1L);
    obj9.setPriceExpressType(3L);
    obj9.setMakeUpType(1L);
    obj9.setSellProfitString1("兜底文案1");
    obj9.setSellProfitString2("兜底文案2");
    obj9.setUsePriceRule(true);
    obj9.setSkuId(0L);
    list8.setPriceRule(obj9);
    obj3.setMergedPic("http://1.jpg");
    obj3.setWarnningMaterials(""1.jpg","2.jpg"");
    req.setPicTagUnitSingles(list2);
    PicassoPictagUnitSaveBatchResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <picasso_pictag_unit_save_batch_response>
        <result>
            <success>false</success>
            <model>
                <fail_detail_list>
                    <fail_detail>
                        <err_msg>排期冲突了</err_msg>
                        <err_code>CONFLICT</err_code>
                        <item_id>9</item_id>
                    </fail_detail>
                </fail_detail_list>
                <fail_count>2</fail_count>
                <succcess_ids>
                    <number></number>
                </succcess_ids>
                <success_count>8</success_count>
            </model>
            <msg_info>1</msg_info>
            <msg_code>1</msg_code>
        </result>
    </picasso_pictag_unit_save_batch_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

    返回
    顶部