文档中心 > API类目 > 天猫好房营销API

alibaba.alihouse.marketing.merchant.coupon.activity.group.add (商家卡券活动圈品元素追加)

商家卡券活动圈品元素追加

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
etc_coupon_activity_invoke_dto ETCCouponActivityInvokeDTO 必须 入参
  • └ activity_id
  • Number
  • 必须
  • 512412
  • 活动ID
  • └ outer_supplier_id
  • Number
  • 必须
  • 421312
  • 卡券供应者ID
  • └ supplier_type
  • Number
  • 必须
  • 2
  • 卡券供应者类型 2:品牌店 3:标准店
participate_group ParticipateGroup 必须 圈品范围结构
  • └ common_store_id_list
  • Number []
  • 可选
  • [12412,4132123]
  • 通用门店列表
  • └ is_common_with_store
  • Boolean
  • 可选
  • true
  • 是否通用
  • participate_struct_list
  • ParticipateStruct []
  • 可选
  • { "common_store_id_list": { "number": [ 1066245126, 1066246123 ] }, "is_common_with_store": true }
  • 圈品结构列表
  • participate_id_list
  • ParticipateIdInfo []
  • 可选
  • [421321,43254]
  • 圈品ID列表
  • └ type
  • Number
  • 可选
  • 3
  • 区分是集中式还是分散式 2:小区 3:公寓
  • └ community_outer_id
  • String
  • 可选
  • 352331
  • /** * 外部父节点ID * (例:圈品类型为小区时, 填外部小区ID) */
  • └ outer_id
  • String
  • 可选
  • 412312312
  • /** * 外部子节点ID * (例:圈品类型为小区房源时, 填外部小区房源ID, 同时填写外部小区ID) */
  • └ store_id
  • Number
  • 可选
  • 213123
  • 门店ID
  • └ type
  • Number
  • 可选
  • 1
  • 圈品类型

响应参数

名称 类型 示例值 描述
result Result 返回结果
  • └ code
  • String
  • success
  • 返回码
  • data
  • ETCCouponActivityAddGroupResp
  • true
  • 返回信息
  • └ is_success
  • Boolean
  • true
  • 是否成功
  • fail_participate_group
  • ParticipateGroup
  • 卡券圈品范围
  • └ is_common_with_store
  • Boolean
  • true
  • 是否全门店通用
  • └ common_store_id_list
  • Number []
  • 通用门店列表
  • participate_struct_list
  • ParticipateStruct []
  • 圈品结构列表
  • participate_id_list
  • ParticipateIdInfo []
  • 圈品ID列表
  • └ type
  • Number
  • 3
  • 区分是集中式还是分散式 2:小区 3:公寓
  • └ community_outer_id
  • String
  • 352331
  • /** * 外部父节点ID * (例:圈品类型为小区时, 填外部小区ID) */
  • └ outer_id
  • String
  • 412312312
  • /** * 外部子节点ID * (例:圈品类型为小区房源时, 填外部小区房源ID, 同时填写外部小区ID) */
  • └ store_id
  • Number
  • 214123
  • 门店ID
  • └ type
  • Number
  • 1
  • 圈品类型
  • └ msg
  • String
  • 成功
  • 返回信息
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest req = new AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest();
AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ETCCouponActivityInvokeDTO obj1 = new AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ETCCouponActivityInvokeDTO();
obj1.setActivityId(512412L);
obj1.setOuterSupplierId(421312L);
obj1.setSupplierType(2L);
req.setEtcCouponActivityInvokeDto(obj1);
AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateGroup obj2 = new AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateGroup();
obj2.setCommonStoreIdList(new Long[] { 12412,4132123 };
);
obj2.setIsCommonWithStore(true);
List<AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateStruct> list4 = new ArrayList<AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateStruct>();
AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateStruct obj5 = new AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateStruct();
list4.add(obj5);
List<AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateIdInfo> list8 = new ArrayList<AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateIdInfo>();
AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateIdInfo obj9 = new AlibabaAlihouseMarketingMerchantCouponActivityGroupAddRequest.ParticipateIdInfo();
list8.add(obj9);
obj9.setType(3L);
obj9.setCommunityOuterId("352331");
obj9.setOuterId("412312312");
list6.setParticipateIdList(list8);
obj5.setStoreId(213123L);
obj5.setType(1L);
obj2.setParticipateStructList(list4);
req.setParticipateGroup(obj2);
AlibabaAlihouseMarketingMerchantCouponActivityGroupAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alihouse_marketing_merchant_coupon_activity_group_add_response>
    <result>
        <code>success</code>
        <data>
            <is_success>true</is_success>
            <fail_participate_group>
                <is_common_with_store>true</is_common_with_store>
                <participate_struct_list>
                    <participate_struct>
                        <participate_id_list>
                            <participate_id_info>
                                <type>3</type>
                                <community_outer_id>352331</community_outer_id>
                                <outer_id>412312312</outer_id>
                            </participate_id_info>
                        </participate_id_list>
                        <store_id>214123</store_id>
                        <type>1</type>
                    </participate_struct>
                </participate_struct_list>
            </fail_participate_group>
        </data>
        <msg>成功</msg>
        <success>true</success>
    </result>
</alibaba_alihouse_marketing_merchant_coupon_activity_group_add_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

返回
顶部