UD计划创建接口
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
request_id | String | 可选 | 1 | 请求id,用于幂等唯一key,创建计划建议填写 本接口需向媒体侧提交任务耗时较长,因TOPAPI 5秒超时限制,可能会在任务执行中提示“超时”/“远程服务调用超时”/“重复请求”等报错,此时可以用相同的request_id进行幂等重试即可返回最新结果 | |
adgroup_top_dto | AdgroupTopDTO | 必须 | 入参 | ||
|
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | AdgroupTopDTO | 返回结果 | |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); UnideskRtaAdAdgroupAddRequest req = new UnideskRtaAdAdgroupAddRequest(); req.setRequestId( "1" ); UnideskRtaAdAdgroupAddRequest.AdgroupTopDTO obj1 = new UnideskRtaAdAdgroupAddRequest.AdgroupTopDTO(); obj1.setSmooth(1L); UnideskRtaAdAdgroupAddRequest.BudgetTopDTO obj2 = new UnideskRtaAdAdgroupAddRequest.BudgetTopDTO(); obj2.setBudgetType(1L); obj2.setBudget(1L); obj2.setDayBudgets( new Long[] { 50000 }; ); obj1.setBudget(obj2); obj1.setCampaignId(1L); UnideskRtaAdAdgroupAddRequest.LandingPageTopDTO obj3 = new UnideskRtaAdAdgroupAddRequest.LandingPageTopDTO(); obj1.setLandingPage(obj3); obj1.setAdvertiserId(1L); UnideskRtaAdAdgroupAddRequest.AdgroupTargetTopDTO obj4 = new UnideskRtaAdAdgroupAddRequest.AdgroupTargetTopDTO(); UnideskRtaAdAdgroupAddRequest.AreaDTO obj5 = new UnideskRtaAdAdgroupAddRequest.AreaDTO(); List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list7 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>(); UnideskRtaAdAdgroupAddRequest.CommonDTO obj8 = new UnideskRtaAdAdgroupAddRequest.CommonDTO(); list7.add(obj8); obj8.setName( "北京" ); obj8.setValue( "11" ); obj5.setCity(list7); obj5.setCityTarget(1L); obj5.setType(1L); obj4.setArea(obj5); UnideskRtaAdAdgroupAddRequest.InterestActionDTO obj9 = new UnideskRtaAdAdgroupAddRequest.InterestActionDTO(); UnideskRtaAdAdgroupAddRequest.ActionCategorieDTO obj10 = new UnideskRtaAdAdgroupAddRequest.ActionCategorieDTO(); List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list12 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>(); UnideskRtaAdAdgroupAddRequest.CommonDTO obj13 = new UnideskRtaAdAdgroupAddRequest.CommonDTO(); list12.add(obj13); obj13.setNum( "11" ); obj13.setName( "名称" ); obj13.setValue( "1" ); obj10.setActionCategories(list12); obj10.setActionScene( "1" ); obj10.setActionDays(1L); List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list15 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>(); UnideskRtaAdAdgroupAddRequest.CommonDTO obj16 = new UnideskRtaAdAdgroupAddRequest.CommonDTO(); list15.add(obj16); obj16.setNum( "1" ); obj16.setName( "名称" ); obj16.setValue( "1" ); obj10.setKeywords(list15); obj10.setActionStrength(0L); obj9.setActionCategorie(obj10); UnideskRtaAdAdgroupAddRequest.InterestCategorieDTO obj17 = new UnideskRtaAdAdgroupAddRequest.InterestCategorieDTO(); List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list19 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>(); UnideskRtaAdAdgroupAddRequest.CommonDTO obj20 = new UnideskRtaAdAdgroupAddRequest.CommonDTO(); list19.add(obj20); obj20.setNum( "1" ); obj20.setName( "名称" ); obj20.setValue( "1" ); obj17.setKeywords(list19); List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list22 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>(); UnideskRtaAdAdgroupAddRequest.CommonDTO obj23 = new UnideskRtaAdAdgroupAddRequest.CommonDTO(); list22.add(obj23); obj23.setNum( "1" ); obj23.setName( "名称" ); obj23.setValue( "1" ); obj17.setInterestCategories(list22); obj9.setInterestCategorie(obj17); obj9.setType(1L); obj4.setInterestAction(obj9); obj4.setHideIfConverted(1L); obj4.setNetCarrier( "1" ); obj4.setCareer( "1" ); obj4.setGender(1L); UnideskRtaAdAdgroupAddRequest.DeviceDTO obj24 = new UnideskRtaAdAdgroupAddRequest.DeviceDTO(); obj24.setDeviceBrands( "1" ); obj24.setDevicePriceType(1L); obj24.setDevicePrices( "0" ); obj4.setDevice(obj24); obj4.setAutoExtendTargets( "1" ); UnideskRtaAdAdgroupAddRequest.AgeDTO obj25 = new UnideskRtaAdAdgroupAddRequest.AgeDTO(); obj25.setAgeRange( "1" ); obj25.setCustomAge( "18" ); obj25.setType(2L); obj4.setAge(obj25); List<UnideskRtaAdAdgroupAddRequest.PlatformDTO> list27 = new ArrayList<UnideskRtaAdAdgroupAddRequest.PlatformDTO>(); UnideskRtaAdAdgroupAddRequest.PlatformDTO obj28 = new UnideskRtaAdAdgroupAddRequest.PlatformDTO(); list27.add(obj28); obj28.setType(1L); obj28.setAndroidVersion(4L); obj28.setIosVersion(1L); obj4.setPlatform(list27); UnideskRtaAdAdgroupAddRequest.ToutiaoAdgroupTargetTopDTO obj29 = new UnideskRtaAdAdgroupAddRequest.ToutiaoAdgroupTargetTopDTO(); obj29.setUserActivateType( "1" ); obj29.setSuperiorPopularityType(1L); UnideskRtaAdAdgroupAddRequest.AwemeFanBehaviorDTO obj30 = new UnideskRtaAdAdgroupAddRequest.AwemeFanBehaviorDTO(); List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list32 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>(); UnideskRtaAdAdgroupAddRequest.CommonDTO obj33 = new UnideskRtaAdAdgroupAddRequest.CommonDTO(); list32.add(obj33); obj33.setNum( "1" ); obj33.setName( "名称" ); obj33.setValue( "1" ); obj30.setKeywords(list32); obj30.setAwemeFanDays(1L); obj30.setAwemeFanScene( "1" ); List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list35 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>(); UnideskRtaAdAdgroupAddRequest.CommonDTO obj36 = new UnideskRtaAdAdgroupAddRequest.CommonDTO(); list35.add(obj36); obj36.setNum( "1" ); obj36.setName( "名称" ); obj36.setValue( "1" ); obj30.setAwemeFanCategories(list35); obj29.setAwemeFanBehavior(obj30); obj4.setToutiao(obj29); obj4.setNetwork( "1" ); UnideskRtaAdAdgroupAddRequest.KuaishouAdgroupTargetTopDTO obj37 = new UnideskRtaAdAdgroupAddRequest.KuaishouAdgroupTargetTopDTO(); List<UnideskRtaAdAdgroupAddRequest.CommonDTO> list39 = new ArrayList<UnideskRtaAdAdgroupAddRequest.CommonDTO>(); UnideskRtaAdAdgroupAddRequest.CommonDTO obj40 = new UnideskRtaAdAdgroupAddRequest.CommonDTO(); list39.add(obj40); obj40.setName( "风景-风景" ); obj40.setValue( "2" ); obj37.setFansStar(list39); obj37.setIntelliTargetSwitch(0L); obj4.setKuaishou(obj37); obj1.setTarget(obj4); UnideskRtaAdAdgroupAddRequest.CastTimeTopDTO obj41 = new UnideskRtaAdAdgroupAddRequest.CastTimeTopDTO(); obj41.setTimeSeries( "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111" ); obj41.setTimeType(1L); obj41.setStartTime(StringUtils.parseDateTime( "2022-08-25 00:00:00" )); obj41.setEndTime(StringUtils.parseDateTime( "2022-08-25 00:00:00" )); obj1.setCastTime(obj41); obj1.setCastShowType(1L); obj1.setName( "1" ); UnideskRtaAdAdgroupAddRequest.AdgroupPricingTopDTO obj42 = new UnideskRtaAdAdgroupAddRequest.AdgroupPricingTopDTO(); obj42.setCastTarget(1L); obj42.setConvertTarget(1L); obj42.setBid(1L); obj42.setCpaBid(1L); obj42.setPricingType(1L); obj42.setBidType(1L); obj42.setAdjustCpa(1L); obj42.setRoiGoal( "0.01" ); obj1.setPricing(obj42); UnideskRtaAdAdgroupAddRequest.TencentAdgroupTopDTO obj43 = new UnideskRtaAdAdgroupAddRequest.TencentAdgroupTopDTO(); obj43.setCastScopes( "1" ); obj43.setCreativeGroupDisplayType(1L); obj43.setDeriveSwitch(1L); obj1.setTencent(obj43); UnideskRtaAdAdgroupAddRequest.KuaishouAdgroupTopDTO obj44 = new UnideskRtaAdAdgroupAddRequest.KuaishouAdgroupTopDTO(); obj44.setCastScope(0L); obj1.setKuaishou(obj44); UnideskRtaAdAdgroupAddRequest.ToutiaoAdgroupV2TopDTO obj45 = new UnideskRtaAdAdgroupAddRequest.ToutiaoAdgroupV2TopDTO(); UnideskRtaAdAdgroupAddRequest.ToutiaoMediaCreativeGroupV2TopDTO obj46 = new UnideskRtaAdAdgroupAddRequest.ToutiaoMediaCreativeGroupV2TopDTO(); List<UnideskRtaAdAdgroupAddRequest.MediaMaterialTopDTO> list48 = new ArrayList<UnideskRtaAdAdgroupAddRequest.MediaMaterialTopDTO>(); UnideskRtaAdAdgroupAddRequest.MediaMaterialTopDTO obj49 = new UnideskRtaAdAdgroupAddRequest.MediaMaterialTopDTO(); list48.add(obj49); obj49.setFormat(1L); obj49.setCcMaterialId( "1" ); obj49.setType(1L); UnideskRtaAdAdgroupAddRequest.VideoConverMaterialTopDTO obj51 = new UnideskRtaAdAdgroupAddRequest.VideoConverMaterialTopDTO(); obj51.setCcMaterialId( "1" ); list50.setVideoConverMaterial(obj51); obj49.setDirectMaterialId(1L); obj49.setTalentItemId(1L); obj49.setTalentVideoCoverId( "tos-cn-p-0015/oM" ); obj49.setTalentVideoId( "tos-cn-p-0015/oM" ); obj49.setNativeVideoFormat(1L); obj46.setMaterials(list48); List<UnideskRtaAdAdgroupAddRequest.TextMaterialTopDTO> list53 = new ArrayList<UnideskRtaAdAdgroupAddRequest.TextMaterialTopDTO>(); UnideskRtaAdAdgroupAddRequest.TextMaterialTopDTO obj54 = new UnideskRtaAdAdgroupAddRequest.TextMaterialTopDTO(); list53.add(obj54); obj54.setContent( "文案内容" ); obj46.setTitleMaterials(list53); obj46.setActionTexts( "行动号召" ); obj46.setCreativeComponentId(1L); obj46.setAnchorComponentId(1L); obj46.setAnchorRelatedType(1L); obj45.setMediaCreativeGroup(obj46); UnideskRtaAdAdgroupAddRequest.ToutiaoProductionV2DTO obj55 = new UnideskRtaAdAdgroupAddRequest.ToutiaoProductionV2DTO(); obj55.setName( "产品名称" ); obj55.setMaterialIds( "1" ); obj55.setSellingPoints( "产品卖点" ); obj45.setProduction(obj55); obj45.setAdSource( "广告来源" ); obj45.setCommentSwitch(1L); obj45.setAdDownloadSwitch(1L); UnideskRtaAdAdgroupAddRequest.ToutiaoPromotionIdentityV2TopDTO obj56 = new UnideskRtaAdAdgroupAddRequest.ToutiaoPromotionIdentityV2TopDTO(); obj56.setPromotionType(1L); obj56.setTalentId( "1" ); obj56.setAuthType(1L); obj56.setIsHideVideo(1L); obj45.setPromotionIdentity(obj56); obj1.setToutiaoV2(obj45); obj1.setVersion(9999L); req.setAdgroupTopDto(obj1); UnideskRtaAdAdgroupAddResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 4 5 | < unidesk_rta_ad_adgroup_add_response > < result > < id >1</ id > </ result > </ unidesk_rta_ad_adgroup_add_response > |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
错误码 | 错误描述 | 解决方案 |
---|