koubei.marketing.campaign.activity.modify(活动修改接口)java版-阿里云开发者社区

说明：
本帖是利用支付宝正式环境测试账号测试活动修改接口接口，请求中根据文档传入了必传参数，大家可以配置自己的环境，根据自己的需求严格按照文档要求添加相关的可选参数，此demo仅供参考
测试环境：Eclipse+JDK1.6及以上+Tomcat6.0及以上
需要注意的是当前接口只能针对“已启动(STARTED)”的活动，修改特定的属性。通过活动修改接口，可修改一下几点：活动结束时间/券有效期 —— 只可延长活动库存 —— 只可追加活动参与限制（包含每月/周/日) —— 只可追加活动门店/券适用门店 —— 只可追加
下面以修改营销活动延期1个月为例演示如何使用接口。如需了解更详细的活动创建配置说明，
可参阅进阶说明。
koubei.marketing.campaign.activity.modify(活动修改接口)接口示例代码

package com.alipay.demo;  import java.text.ParseException;import java.text.SimpleDateFormat;import java.util.ArrayList;import java.util.Date;import java.util.List;import java.util.Random;  import com.alipay.api.AlipayApiException;import com.alipay.api.AlipayClient;import com.alipay.api.DefaultAlipayClient;import com.alipay.api.domain.BudgetInfo;import com.alipay.api.domain.ConstraintInfo;import com.alipay.api.domain.ItemInfo;import com.alipay.api.domain.KoubeiMarketingCampaignActivityModifyModel;import com.alipay.api.domain.PidShopInfo;import com.alipay.api.domain.PointCard;import com.alipay.api.domain.PromoTool;import com.alipay.api.domain.PublishChannel;import com.alipay.api.domain.RecruitTool;import com.alipay.api.domain.SendRule;import com.alipay.api.domain.UseRule;import com.alipay.api.domain.Voucher;import com.alipay.api.request.KoubeiMarketingCampaignActivityModifyRequest;import com.alipay.api.response.KoubeiMarketingCampaignActivityModifyResponse;import com.alipay.config.AlipayConfig;  public class koubeiMarketingCampaignActivityModify {    /**     *     * koubei.marketing.campaign.activity.modify 活动修改接口     *     * @throws ParseException     * @throws AlipayApiException     */    public static void main(String[] args) throws ParseException, AlipayApiException {          AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id,                AlipayConfig.merchant_private_key, AlipayConfig.format, AlipayConfig.charset,                AlipayConfig.alipay_public_key, AlipayConfig.sign_type);        KoubeiMarketingCampaignActivityModifyRequest request = new KoubeiMarketingCampaignActivityModifyRequest();        KoubeiMarketingCampaignActivityModifyModel model = new KoubeiMarketingCampaignActivityModifyModel();          // 外部批次ID，用户指定,每次请求保持唯一        model.setOutBizNo(getOutBizNoModify());        // 活动id        model.setCampId("20180314000000002577674000151339");        // 活动名称 不允许修改，必须与活动详情查询的结果保持一致        model.setName("口碑门店消费满10元送1元代金券");        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");        Date startTime = sdf.parse("2018-03-15 00:00:00");        Date endTime = sdf.parse("2018-4-15 00:00:00");        // 活动开始时间 不允许修改，必须与活动详情查询的结果保持一致        model.setStartTime(startTime);        // 活动结束时间 活动结束时间只允许延长        model.setEndTime(endTime);        // 活动类型 不允许修改，必须与活动详情查询的结果保持一致        model.setType("RECHARGE_SEND");        // 活动详细说明 不允许修改，必须与活动详情查询的结果保持一致        model.setDesc("该活动是用于挽回流失用户的");        // 投放渠道 当活动类型为DIRECT_SEND或者REAL_TIME_SEND时必填，为CONSUME_SEND时必须为空        // model.setPublishChannels(getPublishChannelsModify());        // 招商工具        model.setRecruitTool(getRecruitToolModify());        // 活动预算        model.setBudgetInfo(getBudgetInfoModify());        // 活动限制信息        model.setConstraintInfo(getConstraintInfoModify());          /******** 营销工具集 **********/        List toolList = new ArrayList();        toolList.add(getPromoToolModify());        model.setPromoTools(toolList);        request.setBizModel(model);        KoubeiMarketingCampaignActivityModifyResponse response = alipayClient.execute(request);        if (response.isSuccess()) {            System.out.println("调用成功");        } else {            System.out.println("调用失败");        }        System.out.println(response.getBody());    }      // 招商工具信息    private static RecruitTool getRecruitToolModify() throws ParseException {        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");        Date startTime = sdf.parse("2018-03-15 00:00:00");        Date endTime = sdf.parse("2018-04-15 00:00:00");        RecruitTool recruitTool = new RecruitTool();        // 招商开始时间        recruitTool.setStartTime(startTime);        // 招商结束时间        recruitTool.setEndTime(endTime);        // 招商pid和pid对应的门店列表（对于品牌商，此字段必填，活动和券的适用门店为空。对于商圈，此字段需为空，门店需要填在活动和券的适用门店上）        recruitTool.setPidShops(getPidShopsModify());        return recruitTool;    }      // 招商pid和pid对应的门店列表（对于品牌商，此字段必填，活动和券的适用门店为空。对于商圈，此字段需为空，门店需要填在活动和券的适用门店上）    private static List getPidShopsModify() {        List pidShopsList = new ArrayList();        PidShopInfo pidShopInfo = new PidShopInfo();        // 商户pid        pidShopInfo.setPid("2088501624560335");        // pid下的门店列表        pidShopInfo.setShopIds(getShopIdsModify());        pidShopsList.add(pidShopInfo);        return pidShopsList;    }      // pid下的门店列表    private static List getShopIdsModify() {        List shopIds = new ArrayList();        shopIds.add("2017031500077000000027299729");        shopIds.add("2017031000077000000027197410");        return shopIds;    }      /**     * 外部批次ID     *     * @return     */    private static String getOutBizNoModify() {        SimpleDateFormat simpleDateFormat;        simpleDateFormat = new SimpleDateFormat("yyyyMMdd");        Date date = new Date();        String str = simpleDateFormat.format(date);        Random random = new Random();        int rannum = (int) (random.nextDouble() * (999 - 100 + 1)) + 100;// 获取5位随机数        return str + rannum;// 当前时间    }      /**     * 投放渠道 当活动类型为DIRECT_SEND或者REAL_TIME_SEND时必填，为CONSUME_SEND时必须为空     *     * @return     */    private static List getPublishChannelsModify() {        // TODO Auto-generated method stub        List l = new ArrayList();        PublishChannel p = new PublishChannel();        p.setType("SHOP_DETAIL");        p.setName("投放到店铺");        l.add(p);        return l;    }      /**     * 活动限制信息     *     * @return     */    private static ConstraintInfo getConstraintInfoModify() {        ConstraintInfo constraintInfo = new ConstraintInfo();        // 活动期间用户能够参与的次数限制 ,不填则不做限制        // constraintInfo.setUserWinCount("1");        // 活动期间用户能够参与的频率限制 ,不填则不限制参与频率， 每日中奖1次: D||1        // constraintInfo.setUserWinFrequency("D||3");        // 人群规则组ID 人群规则组ID 仅直发奖类型活动设置有效，通过调用营销活动人群组规则创建接口参数返回        // 针对指定人群的约束条件        // constraintInfo.setCrowdRestriction("NEW_MEMBER_PROMO");        // 活动适用的门店列表仅品牌商发起的招商活动可为空 最多支持10w家门店        constraintInfo.setSuitShops(getSuitShopsModify());        // 最低消费金额，单位元 仅在创建消费送礼包活动时设置        // constraintInfo.setMinCost("10");        return constraintInfo;    }      /**     * 券对象，当活动类型为POINT_SEND时为null，其他活动类型此字段必填     *     * @return     * @throws ParseException     */    private static Voucher getVoucherModify() throws ParseException {        Voucher voucher = new Voucher();        // 券类型，目前支持以下类型： EXCHANGE：兑换券; MONEY：代金券; REDUCETO：减至券; RATE：折扣券        voucher.setType("MONEY");        // 该字段仅在兑换券条件下(即券类型为EXCHANGE)，用于设置兑换券的核销方式        // voucher.setVerifyMode("MERCHANT_SCAN");        // 名称        voucher.setName("口碑门店满20减5");          // 券的使用说明        List UseInstructionsList = new ArrayList();        UseInstructionsList.add("口碑门店满20减5特价优惠");        voucher.setUseInstructions(UseInstructionsList);        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");        Date startTime = sdf.parse("2018-03-15 00:00:00");        Date endTime = sdf.parse("2018-04-15 00:00:00");        voucher.setStartTime(startTime);        voucher.setEndTime(endTime);        // 券LOGO文件ID，调用图片上传接口alipay.offline.material.image.upload获得        voucher.setLogo("gKpPK40RSNeBiMxDsat8CQAAACMAAQED");        // 券有效期类型，目前支持以下类型： RELATIVE：相对有效期 ,FIXED：绝对有效期        voucher.setValidateType("FIXED");        // 券副标题        voucher.setBrandName("券副标题测试");        // 券生效的方式，目前支持以下方式 立即生效：IMMEDIATELY; 延迟生效：DELAY 仅在券有效期类型为相对有效期时生效        voucher.setEffectType("IMMEDIATELY");        // 券面额        voucher.setWorthValue("1");        // 券的使用规则信息        voucher.setUseRule(getUseRuleModify());        // 单品信息 兑换券不允许设置单品信息 减至券必须设置单品信息 其他类型券可按需设置        voucher.setItemInfo(getItemInfoModify());        // 券的备注        voucher.setVoucherNote("券的备注测试");        return voucher;    }      /**     * Item_Info 单品信息     *     * @return     */    private static ItemInfo getItemInfoModify() {        // TODO Auto-generated method stub        ItemInfo itemInfo = new ItemInfo();        // 单品券说明        itemInfo.setItemText("单品卷测试");        // 单品名称        itemInfo.setItemName("测试单品优惠");        // 券适用的单品码列表 最少配置1个单品码 最多配置500个单品码        itemInfo.setItemIds(getitemIdsModify());        return itemInfo;    }      /**     * item_ids 单品码列表     *     * @return     */    private static List getitemIdsModify() {          List l = new ArrayList();        l.add("000123456");        return l;    }      /**     * 券的使用规则信息     *     * @return     */    private static UseRule getUseRuleModify() {        UseRule useRule = new UseRule();        // 券适用门店列表        // 仅品牌商发起的招商活动可为空        // 直发奖类型活动必须与活动适用门店一致        // 最多支持10w家门店        useRule.setSuitShops(getSuitShopsModify());        return useRule;    }      /**     * 活动适用的门店列表 仅品牌商发起的招商活动可为空 最多支持10w家门店     *     * @return     */    private static List getSuitShopsModify() {          List SuitShops = new ArrayList();        SuitShops.add("2017031500077000000027299729");        SuitShops.add("2017031000077000000027197410");        return SuitShops;    }      /**     * 营销工具集     *     * @return     * @throws ParseException     */    private static PromoTool getPromoToolModify() throws ParseException {        PromoTool promoTool = new PromoTool();        // 券对象        promoTool.setVoucher(getVoucherModify());        // 单个营销工具的生效状态，当在招商部分券失效后会使用这个字段        // promoTool.setStatus("");        // 奖品发放的规则        promoTool.setSendRule(getSendRuleModify());        // 集点卡工具，仅在活动类型为POINT_SEND时才有效且必填，其他活动类型此字段必须为null        // promoTool.setPointCard(getPointCardModify());        // 奖品发放的规则        promoTool.setSendRule(getSendRuleModify());        return promoTool;    }      /**     * 集点卡工具，仅在活动类型为POINT_SEND时才有效且必填，其他活动类型此字段必须为null     *     */    private static PointCard getPointCardModify() {          PointCard pointCard = new PointCard();        // 工具类型，目前支持： 集点卡：POINT_CARD        // pointCard.setType("POINT_CARD");        // //工具的名称        // pointCard.setName("集点卡");        // //工具的描述        // pointCard.setDesc("集点卡的功能描述");        // //工具的有效期的起始时间        // pointCard.setStartTime(startTime);        // //工具的有效期的结束时间（必须晚于活动的结束时间）        // pointCard.setEndTime(endTime);        // //工具的LOGO文件ID        // pointCard.setLogo("1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC");          return pointCard;    }      /**     * 奖品发放的规则     *     * @return     */    private static SendRule getSendRuleModify() {        // TODO Auto-generated method stub        SendRule s = new SendRule();        // 发券最低消费金额        s.setMinCost("100");        return s;    }      /**     * 活动预算     *     * @return     */    private static BudgetInfo getBudgetInfoModify() {        // 活动预算        BudgetInfo budgetInfo = new BudgetInfo();        // 预算类型        budgetInfo.setBudgetType("QUANTITY");        // 预算数量        budgetInfo.setBudgetTotal("10258");        return budgetInfo;    }  }

请求参数注意事项：

1.app_auth_token：ISV/开发者可以通过第三方应用授权（[url]https://openclub.alipay.com/read.php?tid=1649[/url]）得到商家授权令牌（app_auth_token）作为请求参数传入，实现代商家发起请求的能力；
2.voucher.Logo：券LOGO文件ID，调用alipay.offline.material.image.upload(图片上传接口)获得，接口示例
可点击[url]https://openclub.alipay.com/read.php?tid=2316[/url]根据帖子进行测试获取image_id
3.SuitShops：活动适用的门店列表，这个需要使用查询商户的门店编号列表接口（[url]https://openclub.alipay.com/read.php?tid=2321[/url]）进行查询获取
4.camp_id（活动id）通过koubei.marketing.campaign.activity.create (活动创建接口)（[url]https://openclub.alipay.com/read.php?tid=2638[/url]）调用成功同步返回

5.name 活动名称不允许修改，必须与活动详情查询的结果保持一致
6.start_time 活动开始时间不允许修改，必须与活动详情查询的结果保持一致
7.end_time 活动结束时间活动结束时间只允许延长
[color='''''rgba(0, 0, 0, 0.650980392156863)''''']8.type 活动类型不允许修改，必须与活动详情查询的结果保持一致[color='''''rgba(0, 0, 0, 0.650980392156863)''''']9.desc 活动详细说明不允许修改，必须与活动详情查询的结果保持一致
调用成功返回信息：

{"koubei_marketing_campaign_activity_modify_response":{"code":"10000","msg":"Success","camp_status":"MODIFYING"},"sign":"ZEzTg0IckPXO/OFrvi1g5q6bwTE20DfWe+XU2mGuxu3YOgQiVrhnz1H6oL5MFSHLT2/rv5mEtNk8NwBldJki826ZzcOjy03oRDfTgpiFnEFGjAebDGz2Rz3r8rjDr2JDtyPXlFTGSFtMqa8qPzSS7d8ZMRS8HCMD8crxWOOhZbs="}

如何查看生成的优惠券：
1.创建活动成功后，可以到沙箱工具中点击口碑门店账号&二维码转换工具：[url]https://openhome.alipay.com/platform/appDaily.htm?tab=tool[/url]