注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 阿里妈妈开放业务

单元接口

更新时间:2017/11/22 访问次数:678

一、获取单个单元(taobao.zuanshi.banner.adgroup.get)

ZuanshiBannerAdgroupGetRequest request = new ZuanshiBannerAdgroupGetRequest();
        //单元ID
        request.setId(226047553l);
        ZuanshiBannerAdgroupGetResponse response = null;
        try {
            response = client.execute(request, sessionKey);
        } catch (ApiException e) {
            e.printStackTrace();
        }
        if (response.isSuccess()) {
            return JSONUtils.toJsonPrettyPrinting(response.getResult());
        }
        return response.getSubMsg();

二、单元删除(taobao.zuanshi.banner.adgroup.delete)

ZuanshiBannerAdgroupDeleteRequest request = new ZuanshiBannerAdgroupDeleteRequest();
        //计划ID
        request.setCampaignId(223367576l);
        //单元ID
        request.setAdgroupIdList("226047553");
        ZuanshiBannerAdgroupDeleteResponse response = null;
        try {
            response = client.execute(request, sessionKey);
        } catch (ApiException e) {
            e.printStackTrace();
        }
        if (response.isSuccess()) {
            return JSONUtils.toJsonPrettyPrinting(response);
        }
        return response.getSubMsg();

三、获取单元列表(taobao.zuanshi.banner.adgroup.find)

ZuanshiBannerAdgroupFindRequest request = new ZuanshiBannerAdgroupFindRequest();
        //计划ID
        request.setCampaignId(223367576l);
        //单元名称,模糊匹配
        request.setName("资源");
        ZuanshiBannerAdgroupFindResponse response = null;
        try {
            response = client.execute(request, sessionKey);
        } catch (ApiException e) {
            e.printStackTrace();
        }
        if (response.isSuccess()) {
            return JSONUtils.toJsonPrettyPrinting(response);
        }
        return response.getSubMsg();

四、单元状态修改(taobao.zuanshi.banner.adgroup.status)

ZuanshiBannerAdgroupStatusRequest request = new ZuanshiBannerAdgroupStatusRequest();
        //计划ID
        request.setCampaignId(223367576l);
        //单元ID
        request.setAdgroupIdList("226047553");
        //计划状态,0:暂停,1:投放,9:投放结束
        request.setStatus(0l);
        ZuanshiBannerAdgroupStatusResponse response = null;
        try {
            response = client.execute(request, sessionKey);
        } catch (ApiException e) {
            e.printStackTrace();
        }
        if (response.isSuccess()) {
            return JSONUtils.toJsonPrettyPrinting(response);
        }
        return response.getSubMsg();

五、单元创建(taobao.zuanshi.banner.adgroup.create)

ZuanshiBannerAdgroupCreateRequest request = new ZuanshiBannerAdgroupCreateRequest();
        //计划ID
        request.setCampaignId(223367576l);
        //计划名称
        request.setName("top工具生成的单元");
        ZuanshiBannerAdgroupCreateRequest.Crowd crowd = new ZuanshiBannerAdgroupCreateRequest.Crowd();
        //定向名称
        crowd.setCrowdName("通投");
        //定向类型
        crowd.setCrowdType(0l);
        //定向值
        crowd.setCrowdValue("10");
        ZuanshiBannerAdgroupCreateRequest.MatrixPrice matrixPrice = new ZuanshiBannerAdgroupCreateRequest.MatrixPrice();
        //资源位ID
        matrixPrice.setAdzoneId(21374664l);
        //出价
        matrixPrice.setPrice(100l);
        ZuanshiBannerAdgroupCreateRequest.SubCrowd subCrowd = new ZuanshiBannerAdgroupCreateRequest.SubCrowd();
        //子定向名称
        subCrowd.setSubCrowdName("通投");
        //子定向值
        subCrowd.setSubCrowdValue("all");
        crowd.setMatrixPrice(Lists.newArrayList(matrixPrice));
        crowd.setSubCrowds(Lists.newArrayList(subCrowd));
        request.setCrowds(Lists.newArrayList(crowd));
        ZuanshiBannerAdgroupCreateRequest.AdzoneBid adzoneBid = new ZuanshiBannerAdgroupCreateRequest.AdzoneBid();
        adzoneBid.setAdzoneId(21374664l);
        request.setAdzoneBidList(Lists.newArrayList(adzoneBid));
        ZuanshiBannerAdgroupCreateResponse response = null;
        try {
            response = client.execute(request, sessionKey);
        } catch (ApiException e) {
            e.printStackTrace();
        }
        if (response.isSuccess()) {
            return JSONUtils.toJsonPrettyPrinting(response);
        }
        return response.getSubMsg();

六、单元修改(taobao.zuanshi.banner.adgroup.modify)

  • 单元名称要求:只支持汉字、字母、数字、下划线。
ZuanshiBannerAdgroupModifyRequest request = new ZuanshiBannerAdgroupModifyRequest();
        //计划ID
        request.setCampaignId(223367576l);
        //单元ID
        request.setId(226047553l);
        //单元名称
        request.setName("修改后的单元名称");
        //创意优选,1:开启,0关闭
        request.setAdboardFilter(1l);
        //智能出价,1:开启,0:关闭
        request.setIntelligentBid(1l);
        ZuanshiBannerAdgroupModifyResponse response = null;
        try {
            response = client.execute(request, sessionKey);
        } catch (ApiException e) {
            e.printStackTrace();
        }
        if (response.isSuccess()) {
            return JSONUtils.toJsonPrettyPrinting(response);
        }
        return response.getSubMsg();

FAQ

关于此文档暂时还没有FAQ
返回
顶部