广告位相关API的调用示例

一、获取广告位的查询条件（taobao.zuanshi.banner.adzone.condition）

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
        ZuanshiBannerAdzoneConditionRequest request = new ZuanshiBannerAdzoneConditionRequest();
        ZuanshiBannerAdzoneConditionResponse response = null;
        try {
            response = client.execute(request, sessionKey);
        } catch (ApiException e) {
            e.printStackTrace();
        }
        if (response.isSuccess()) {
            AdzoneQuery adzoneQuery = response.getResult().getCondition();
            // 尺寸列表
            adzoneQuery.getAdzoneSizeList();
            // 允许创意类型
            adzoneQuery.getAllowAdFormatList();
            // 媒体类型
            adzoneQuery.getMediaTypeList();
            // 结算类型
            adzoneQuery.getSettleTypeList();          
        }

二、分页获取广告位信息列表（taobao.zuanshi.banner.adzone.condition）

分页查询广告位列表，对于查询CPM和CPC的广告位，通过设置SettleType来过滤

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    	ZuanshiBannerAdzoneFindpageRequest request = new ZuanshiBannerAdzoneFindpageRequest();
    	request.setSettleTypeList("1");//CPM
    	//... 设置其它查询条件
    	ZuanshiBannerAdzoneFindpageResponse response = null;
    	try {
    		response = client.execute(request, sessionKey);
    	} catch (ApiException e) {
    		e.printStackTrace();
    	}
    	if (response.isSuccess()) {
    		Long totalCount = response.getResult().getTotalCount();
    		List<AdzoneDto> list= response.getResult().getList();
    		System.out.println(totalCount);
    		System.out.println(list);
    	}

三、分页获取推广单元绑定的广告位列表（taobao.zuanshi.banner.adgroup.adzone.findpage）

包括了出价信息

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    	ZuanshiBannerAdgroupAdzoneFindpageRequest request = new ZuanshiBannerAdgroupAdzoneFindpageRequest();
    	request.setCampaignId(111111l);
    	request.setAdgroupId(222222l);
    	//... 设置其它查询条件
    	ZuanshiBannerAdgroupAdzoneFindpageResponse response = null;
    	try {
    		response = client.execute(request, sessionKey);
    	} catch (ApiException e) {
    		e.printStackTrace();
    	}
    	if (response.isSuccess()) {
    		Long totalCount = response.getResult().getTotalCount();
    		// 广告位列表
    		List<AdzoneBidDto> list= response.getResult().getList();
    		for(AdzoneBidDto adzoneBidDto:list){
    			// 获取交叉出价
    			List<MatrixPriceDto> matrixList = adzoneBidDto.getMatrixPriceList();
    			for(MatrixPriceDto matrixPrice:matrixList){
    				System.out.println(matrixPrice.getCrowdId());
    				System.out.println(matrixPrice.getCrowdType());
    				//出价单位为分
    				System.out.println(matrixPrice.getPrice());
    			}
    		}
    		System.out.println(totalCount);
    		System.out.println(list);
    	}

四、推广单元绑定的广告位接口（ taobao.zuanshi.banner.adgroup.adzone.bind）

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    	ZuanshiBannerAdgroupAdzoneBindRequest request = new ZuanshiBannerAdgroupAdzoneBindRequest();
    	request.setCampaignId(111111l);
    	request.setAdgroupId(222222l);
    	
    	List<com.taobao.api.request.ZuanshiBannerAdgroupAdzoneBindRequest.AdzoneBidDto> adzoneBidList = new ArrayList<ZuanshiBannerAdgroupAdzoneBindRequest.AdzoneBidDto>();
    	com.taobao.api.request.ZuanshiBannerAdgroupAdzoneBindRequest.AdzoneBidDto bidDto = new com.taobao.api.request.ZuanshiBannerAdgroupAdzoneBindRequest.AdzoneBidDto();
    	// 广告位id
    	bidDto.setAdzoneId(1111L);
    	// 交叉出价信息
    	List<com.taobao.api.request.ZuanshiBannerAdgroupAdzoneBindRequest.MatrixPriceDto> matrixList = new ArrayList<ZuanshiBannerAdgroupAdzoneBindRequest.MatrixPriceDto>();
    	com.taobao.api.request.ZuanshiBannerAdgroupAdzoneBindRequest.MatrixPriceDto matrixPriceDto = new com.taobao.api.request.ZuanshiBannerAdgroupAdzoneBindRequest.MatrixPriceDto();
    	// 定向信息
    	matrixPriceDto.setCrowdId(222222L);
    	matrixPriceDto.setCrowdType(128L);
    	// 交叉出及
    	matrixPriceDto.setPrice(567L);
    	
    	matrixList.add(matrixPriceDto);
    	bidDto.setMatrixPriceList(matrixList);;
    	adzoneBidList.add(bidDto);
    	
    	request.setAdzoneBidDtoList(adzoneBidList);
    	
    	//... 设置其它查询条件
    	ZuanshiBannerAdgroupAdzoneBindResponse response = null;
    	try {
    		response = client.execute(request, sessionKey);
    	} catch (ApiException e) {
    		e.printStackTrace();
    	}
    	if (response.isSuccess()) {
    		Long count = response.getResult().getCount();
    		System.out.println(count);
    	}

五、推广单元解绑广告位接口（taobao.zuanshi.banner.adgroup.adzone.unbind）

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    	ZuanshiBannerAdgroupAdzoneUnbindRequest request = new ZuanshiBannerAdgroupAdzoneUnbindRequest();
    	request.setCampaignId(111111l);
    	request.setAdgroupId(222222l);
    	// 多个用逗号隔开
    	request.setAdzoneIdList("111,222");
    	ZuanshiBannerAdgroupAdzoneUnbindResponse response = null;
    	try {
    		response = client.execute(request, sessionKey);
    	} catch (ApiException e) {
    		e.printStackTrace();
    	}
    	if (response.isSuccess()) {
    		Long count = response.getResult().getCount();
    		System.out.println(count);
    	}

FAQ