淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	描述
request_id	String	可选	1	请求id，用于幂等唯一key，建议填写本接口需向媒体侧提交任务耗时较长，因TOPAPI 5秒超时限制，可能会在任务执行中提示“超时”/“远程服务调用超时”/“重复请求”等报错，此时可以用相同的request_id进行幂等重试即可返回最新结果
adgroup_top_dto	AdgroupTopDTO	必须		入参，以下字段不修改可不传
└ smooth Number 可选 1 头条投放形式: 1 - 加速投放；2 - 平滑投放；3-优先低成本（投放时间范围只可为全天；预算不可为不限或空）字节2.0不支持. 腾讯出价策略:1-稳定拿量 2-优先拿量 3-优先低成本 budget BudgetTopDTO 可选预算 └ budget_type Number 可选 1 预算类型 -1：不限、1：指定预算（每天预算相同） └ budget Number 可选 1 统一预算金额，单位：分 └ day_budgets Number [] 可选 50000 分日预算，单位：分，周一到周日每天的数组，-1表示不限 └ campaign_id Number 必须 1 计划组id └ advertiser_id Number 必须 1 广告主id target AdgroupTargetTopDTO 可选定向，不修改可不传，如指定会覆盖原有定向（即入参必须填写完整定向内容） area AreaDTO 可选地域定向 city CommonDTO [] 可选 list 地域值 └ name String 可选北京地域名称 └ value String 可选 11 地域值 └ city_target Number 可选 1 城市目标人群，1：正在该地区的用户，2：居住在该地区的用户，3：到该地区旅行的用户，4：该地区内的所有用户 └ type Number 可选 1 地域定向类型，-1:不限，1：指定地区 interest_action InterestActionDTO 可选行为兴趣 action_categorie ActionCategorieDTO 可选行为分类 action_categories CommonDTO [] 可选 list 行为类目 └ num String 可选 11 数量 └ name String 可选名称名称 └ value String 可选 1 值 └ action_scene String [] 可选 1 行为场景，1：电商行为场景，2：咨询行为场景，3：app行为场景 └ action_days Number 可选 1 行为天数，1：7天，2：15天，3：30天，4：60天，5：90天，6：180天，7：365天 keywords CommonDTO [] 可选 list 关键词 └ num String 可选 1 数量 └ name String 可选名称名称 └ value String 可选 1 值 interest_categorie InterestCategorieDTO 可选兴趣分类 keywords CommonDTO [] 可选 list 关键词 └ num String 可选 1 数量 └ name String 可选名称名称 └ value String 可选 1 值 interest_categories CommonDTO [] 可选 list 行文类目 └ num String 可选 1 数量 └ name String 可选名称名称 └ value String 可选 1 值 └ type Number 可选 1 1,系统推荐 2 自定义 └ hide_if_converted Number 可选 1 过滤已转化用户，0(默认)：不限；1：广告组2：广告计划；3：本账户；4：公司主体；5：APP └ net_carrier String [] 可选 1 网络运营商，-1：不限，1：移动，2：联通，3：电信 └ career String [] 可选 1 职业，1：大学生，2：教师，3：IT，4：公务员，5：金融，6：医务人员 └ gender Number 可选 1 性别，-1：不限，1：女，2：男 device DeviceDTO 可选设备-品牌/价格 └ device_brands String [] 可选 1 设备品牌，1：荣耀，2：苹果，3：华为，4：小米，5：三星，6：OPPO，7：VIVO，8：魅族，9：金立，10：酷派，11：联想，12：乐视，13：中兴，14：中国移动，15：HTC，16：小辣椒，17：努比亚，18：海信，19：奇酷，20：TCL，21：索尼，22：锤子手机，23：360手机，24：一加手机，25：LG，26：摩托罗拉，27：诺基亚，28：谷歌，100：其他 └ device_price_type Number 可选 1 设备价格类型方式：，0：手动定义 └ device_prices String [] 可选 0 设备价格，最小价格-最大价格 └ auto_extend_targets String [] 可选 1 智能放量，1：年龄，2：性别，3：地域，4：行为兴趣，5：学历 age AgeDTO 可选年龄 └ age_range String [] 可选 1 年龄，-1：不限，18：18-23，24：24-30，31：31-40，41：41-49，50：50-100 └ custom_age String [] 可选 18 自定义年龄段，数组size=2，第一位传最小值、第二位传最大值 └ type Number 可选 2 类型，-1：不限，1:选择年龄段，2：自定义年龄段 platform PlatformDTO [] 可选 list 平台 └ type Number 可选 1 操作系统类型，-1：不限，1：安卓，3：iOS └ android_version Number 可选 4 安卓版本，-1:不限,4:4.x+,5:5.x+,6:6.x+,7:7.x+,8:8.x+,9:9.x+,10:10.x+ └ ios_version Number 可选 1 iOS版本，-1：不限，7：7.x+，8：8.x+，9：9.x+，10：10.x+，11：11.x+，12：12.x+，13：13.x+ toutiao ToutiaoAdgroupTargetTopDTO 可选头条特有定向 └ user_activate_type String [] 可选 1 新用户，-1：不限，1：一个月内，2：一个月到三个月，3：三个月以上 └ superior_popularity_type Number 可选 1 流量精选包，-1：不限，2：游戏精选流量包 aweme_fan_behavior AwemeFanBehaviorDTO 可选抖音达人定向 keywords CommonDTO [] 可选 list 关键词 └ num String 可选 1 数量 └ name String 可选名称名称 └ value String 可选 1 值 └ aweme_fan_days Number 可选 1 互动天数，1：15天，2：30天，3：60天 └ aweme_fan_scene String [] 可选 SHARED_USER 行为场景，1：关注，2：评论，3：点赞，4：分享 aweme_fan_categories CommonDTO [] 可选 list 抖音达人账号类目 └ num String 可选 1 数量 └ name String 可选名称名称 └ value String 可选 1 值 └ network String [] 可选 1 网络，-1：不限，0：Wi-Fi，1：移动网络，2：2G，3：3G，4：4G kuaishou KuaishouAdgroupTargetTopDTO 可选快手特有定向 fans_star CommonDTO [] 可选 1 网红粉丝 └ name String 可选风景-风景名称 └ value String 可选 2 值 └ intelli_target_switch Number 可选 0 智能定向,0:关闭 1:开启。默认为关闭 cast_time CastTimeTopDTO 可选投放周期 └ time_series String 可选 111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111 时段，247 位 0 或 1 组成的字符串，小时粒度；从周一 0 点开始到周日 24 点结束，0 不投放，1 投放; 禁止全部为 0，不传或者全部为 1，表示全时段投放 └ time_type Number 可选 1 投放周期类型，0：从今天起长期投放，1：设置开始和结束日期 └ start_time Date 可选 2022-08-25 00:00:00 投放周期，开始时间 └ end_time Date 可选 2022-08-25 00:00:00 投放周期，结束时间 └ name String 可选 1 名称 pricing AdgroupPricingTopDTO 可选付费出价 └ bid Number 可选 1 基础出价 └ cpa_bid Number 可选 1 转化目标出价 └ adjust_cpa Number 可选 1 是否调整自动出价，1：是，0：否 └ roi_goal String 可选 0.01 roi系数头条2.0使用,项目开启深度优化后可填 └ id Number 必须 1 计划id landing_page LandingPageTopDTO 可选落地页 └ dp_link_url String 可选 tbopen://m.taobao.com/tbopen 自定义deeplink，需要UDBP开通白名单功能才能使用 toutiao_v2 ToutiaoAdgroupV2TopDTO 可选头条2.0特有参数 promotion_identity ToutiaoPromotionIdentityV2TopDTO 可选广告推广主体 └ promotion_type Number 可选 1 推广类型:1：抖音号，2：账户信息 └ talent_id String 可选抖音达人ID 抖音达人ID └ is_hide_video Number 可选 1 是否主页作品列表隐藏广告内容：1：隐藏，0：不隐藏 media_creative_group ToutiaoMediaCreativeGroupV2TopDTO 可选创意素材 materials MediaMaterialTopDTO [] 可选视频素材，图片和视频素材上限均为10个 └ format Number 可选 1 广告形式，1：竖版视频，2：横版视频，3：大图横图，5：小图，6：大图竖图，7：开屏图片。竖版视频：格式要求：mp4、mpeg、3gp、avi 视频格式，建议尺寸要求：宽高比9:16，分辨率≥ 7201280，视频码率≥516kbps，时长≥4s；竖版视频-视频封面：格式要求：jpg、jpeg、png 图片格式，尺寸要求：宽高比9:16，14402560 ≤ 尺寸≥ 7201280；横版视频：格式要求：mp4、mpeg、3gp、avi 视频格式，建议尺寸要求：宽高比16:9，分辨率≥ 1280720，视频码率≥516kbps，时长≥4s,大小≤1000M；横版视频-视频封面：格式要求：jpg、jpeg、png 图片格式，尺寸要求：宽高比16:9，25601440 ≤ 尺寸≥ 1280720；大图横图：格式要求：jpg、jpeg、png 图片格式，尺寸要求：宽高比16:9，25601440 ≤ 尺寸≥ 1280720；小图：格式要求：jpg、jpeg、png 图片格式，尺寸要求：宽高比1.52，1368900 ≤ 尺寸≥ 456300；大图竖图：格式要求：jpg、jpeg、png 图片格式，尺寸要求：宽高比9:16，14402560 ≤ 尺寸≥ 720*1280； └ cc_material_id String 可选 1 素材id └ type Number 可选 1 素材类型，1：图片，2：视频 video_conver_material VideoConverMaterialTopDTO 可选视频封面 └ cc_material_id String 可选 1 素材id title_materials TextMaterialDTO [] 可选标题，最多添加10个标题，每个标题最多30个字 └ content String 可选文案内容文案内容 └ derive_switch Number 可选 1 头条2.0暂不支持。智能创意自动生成开关：1：开启，0：关闭 └ action_texts String [] 可选行动号召行动号召 └ creative_component_id Number 可选 1 创意组件ID └ anchor_component_id Number 可选 1 锚点组件id └ anchor_related_type Number 可选 1 锚点启用类型 1 不启用 2 手动选择注:账户类型为深转,推广目的为电商店铺推广且为原生广告投放才可使用锚点 production ToutiaoProductionV2DTO 可选产品信息 └ name String 可选产品名称产品名称 └ material_ids String [] 可选 1 产品主图素材 └ selling_points String [] 可选产品卖点产品卖点，最多10条 └ ad_source String 可选广告来源广告来源 └ comment_switch Number 可选 1 是否开启评论功能：1：开启，0：关闭 └ ad_download_switch Number 可选 1 客户端下载视频开关：1：开启，0：关闭 └ version Number 可选 9999 平台版本，9999：升级版API（仅巨量2.0API需传入）

名称	类型	示例值	描述
result	AdgroupTopDTO		返回结果
└ id Number 1 计划id

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaAdAdgroupUpdateRequest req = new UnideskRtaAdAdgroupUpdateRequest();
req.setRequestId("1");
UnideskRtaAdAdgroupUpdateRequest.AdgroupTopDTO obj1 = new UnideskRtaAdAdgroupUpdateRequest.AdgroupTopDTO();
obj1.setSmooth(1L);
UnideskRtaAdAdgroupUpdateRequest.BudgetTopDTO obj2 = new UnideskRtaAdAdgroupUpdateRequest.BudgetTopDTO();
obj2.setBudgetType(1L);
obj2.setBudget(1L);
obj2.setDayBudgets(new Long[] { 50000 };
);
obj1.setBudget(obj2);
obj1.setCampaignId(1L);
obj1.setAdvertiserId(1L);
UnideskRtaAdAdgroupUpdateRequest.AdgroupTargetTopDTO obj3 = new UnideskRtaAdAdgroupUpdateRequest.AdgroupTargetTopDTO();
UnideskRtaAdAdgroupUpdateRequest.AreaDTO obj4 = new UnideskRtaAdAdgroupUpdateRequest.AreaDTO();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTO> list6 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.CommonDTO>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTO obj7 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTO();
list6.add(obj7);
obj7.setName("北京");
obj7.setValue("11");
obj4.setCity(list6);
obj4.setCityTarget(1L);
obj4.setType(1L);
obj3.setArea(obj4);
UnideskRtaAdAdgroupUpdateRequest.InterestActionDTO obj8 = new UnideskRtaAdAdgroupUpdateRequest.InterestActionDTO();
UnideskRtaAdAdgroupUpdateRequest.ActionCategorieDTO obj9 = new UnideskRtaAdAdgroupUpdateRequest.ActionCategorieDTO();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTO> list11 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.CommonDTO>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTO obj12 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTO();
list11.add(obj12);
obj12.setNum("11");
obj12.setName("名称");
obj12.setValue("1");
obj9.setActionCategories(list11);
obj9.setActionScene("1");
obj9.setActionDays(1L);
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTO> list14 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.CommonDTO>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTO obj15 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTO();
list14.add(obj15);
obj15.setNum("1");
obj15.setName("名称");
obj15.setValue("1");
obj9.setKeywords(list14);
obj8.setActionCategorie(obj9);
UnideskRtaAdAdgroupUpdateRequest.InterestCategorieDTO obj16 = new UnideskRtaAdAdgroupUpdateRequest.InterestCategorieDTO();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTO> list18 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.CommonDTO>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTO obj19 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTO();
list18.add(obj19);
obj19.setNum("1");
obj19.setName("名称");
obj19.setValue("1");
obj16.setKeywords(list18);
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTO> list21 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.CommonDTO>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTO obj22 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTO();
list21.add(obj22);
obj22.setNum("1");
obj22.setName("名称");
obj22.setValue("1");
obj16.setInterestCategories(list21);
obj8.setInterestCategorie(obj16);
obj8.setType(1L);
obj3.setInterestAction(obj8);
obj3.setHideIfConverted(1L);
obj3.setNetCarrier("1");
obj3.setCareer("1");
obj3.setGender(1L);
UnideskRtaAdAdgroupUpdateRequest.DeviceDTO obj23 = new UnideskRtaAdAdgroupUpdateRequest.DeviceDTO();
obj23.setDeviceBrands("1");
obj23.setDevicePriceType(1L);
obj23.setDevicePrices("0");
obj3.setDevice(obj23);
obj3.setAutoExtendTargets("1");
UnideskRtaAdAdgroupUpdateRequest.AgeDTO obj24 = new UnideskRtaAdAdgroupUpdateRequest.AgeDTO();
obj24.setAgeRange("1");
obj24.setCustomAge("18");
obj24.setType(2L);
obj3.setAge(obj24);
List<UnideskRtaAdAdgroupUpdateRequest.PlatformDTO> list26 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.PlatformDTO>();
UnideskRtaAdAdgroupUpdateRequest.PlatformDTO obj27 = new UnideskRtaAdAdgroupUpdateRequest.PlatformDTO();
list26.add(obj27);
obj27.setType(1L);
obj27.setAndroidVersion(4L);
obj27.setIosVersion(1L);
obj3.setPlatform(list26);
UnideskRtaAdAdgroupUpdateRequest.ToutiaoAdgroupTargetTopDTO obj28 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoAdgroupTargetTopDTO();
obj28.setUserActivateType("1");
obj28.setSuperiorPopularityType(1L);
UnideskRtaAdAdgroupUpdateRequest.AwemeFanBehaviorDTO obj29 = new UnideskRtaAdAdgroupUpdateRequest.AwemeFanBehaviorDTO();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTO> list31 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.CommonDTO>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTO obj32 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTO();
list31.add(obj32);
obj32.setNum("1");
obj32.setName("名称");
obj32.setValue("1");
obj29.setKeywords(list31);
obj29.setAwemeFanDays(1L);
obj29.setAwemeFanScene("SHARED_USER");
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTO> list34 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.CommonDTO>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTO obj35 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTO();
list34.add(obj35);
obj35.setNum("1");
obj35.setName("名称");
obj35.setValue("1");
obj29.setAwemeFanCategories(list34);
obj28.setAwemeFanBehavior(obj29);
obj3.setToutiao(obj28);
obj3.setNetwork("1");
UnideskRtaAdAdgroupUpdateRequest.KuaishouAdgroupTargetTopDTO obj36 = new UnideskRtaAdAdgroupUpdateRequest.KuaishouAdgroupTargetTopDTO();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTO> list38 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.CommonDTO>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTO obj39 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTO();
list38.add(obj39);
obj39.setName("风景-风景");
obj39.setValue("2");
obj36.setFansStar(list38);
obj36.setIntelliTargetSwitch(0L);
obj3.setKuaishou(obj36);
obj1.setTarget(obj3);
UnideskRtaAdAdgroupUpdateRequest.CastTimeTopDTO obj40 = new UnideskRtaAdAdgroupUpdateRequest.CastTimeTopDTO();
obj40.setTimeSeries("111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111");
obj40.setTimeType(1L);
obj40.setStartTime(StringUtils.parseDateTime("2022-08-25 00:00:00"));
obj40.setEndTime(StringUtils.parseDateTime("2022-08-25 00:00:00"));
obj1.setCastTime(obj40);
obj1.setName("1");
UnideskRtaAdAdgroupUpdateRequest.AdgroupPricingTopDTO obj41 = new UnideskRtaAdAdgroupUpdateRequest.AdgroupPricingTopDTO();
obj41.setBid(1L);
obj41.setCpaBid(1L);
obj41.setAdjustCpa(1L);
obj41.setRoiGoal("0.01");
obj1.setPricing(obj41);
obj1.setId(1L);
UnideskRtaAdAdgroupUpdateRequest.LandingPageTopDTO obj42 = new UnideskRtaAdAdgroupUpdateRequest.LandingPageTopDTO();
obj42.setDpLinkUrl("tbopen://m.taobao.com/tbopen");
obj1.setLandingPage(obj42);
UnideskRtaAdAdgroupUpdateRequest.ToutiaoAdgroupV2TopDTO obj43 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoAdgroupV2TopDTO();
UnideskRtaAdAdgroupUpdateRequest.ToutiaoPromotionIdentityV2TopDTO obj44 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoPromotionIdentityV2TopDTO();
obj44.setPromotionType(1L);
obj44.setTalentId("抖音达人ID");
obj44.setIsHideVideo(1L);
obj43.setPromotionIdentity(obj44);
UnideskRtaAdAdgroupUpdateRequest.ToutiaoMediaCreativeGroupV2TopDTO obj45 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoMediaCreativeGroupV2TopDTO();
List<UnideskRtaAdAdgroupUpdateRequest.MediaMaterialTopDTO> list47 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.MediaMaterialTopDTO>();
UnideskRtaAdAdgroupUpdateRequest.MediaMaterialTopDTO obj48 = new UnideskRtaAdAdgroupUpdateRequest.MediaMaterialTopDTO();
list47.add(obj48);
obj48.setFormat(1L);
obj48.setCcMaterialId("1");
obj48.setType(1L);
UnideskRtaAdAdgroupUpdateRequest.VideoConverMaterialTopDTO obj50 = new UnideskRtaAdAdgroupUpdateRequest.VideoConverMaterialTopDTO();
obj50.setCcMaterialId("1");
list49.setVideoConverMaterial(obj50);
obj45.setMaterials(list47);
List<UnideskRtaAdAdgroupUpdateRequest.TextMaterialDTO> list52 = new ArrayList<UnideskRtaAdAdgroupUpdateRequest.TextMaterialDTO>();
UnideskRtaAdAdgroupUpdateRequest.TextMaterialDTO obj53 = new UnideskRtaAdAdgroupUpdateRequest.TextMaterialDTO();
list52.add(obj53);
obj53.setContent("文案内容");
obj45.setTitleMaterials(list52);
obj45.setDeriveSwitch(1L);
obj45.setActionTexts("行动号召");
obj45.setCreativeComponentId(1L);
obj45.setAnchorComponentId(1L);
obj45.setAnchorRelatedType(1L);
obj43.setMediaCreativeGroup(obj45);
UnideskRtaAdAdgroupUpdateRequest.ToutiaoProductionV2DTO obj54 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoProductionV2DTO();
obj54.setName("产品名称");
obj54.setMaterialIds("1");
obj54.setSellingPoints("产品卖点");
obj43.setProduction(obj54);
obj43.setAdSource("广告来源");
obj43.setCommentSwitch(1L);
obj43.setAdDownloadSwitch(1L);
obj1.setToutiaoV2(obj43);
obj1.setVersion(9999L);
req.setAdgroupTopDto(obj1);
UnideskRtaAdAdgroupUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
UnideskRtaAdAdgroupUpdateRequest req = new UnideskRtaAdAdgroupUpdateRequest();
req.RequestId = "1";
UnideskRtaAdAdgroupUpdateRequest.AdgroupTopDTODomain obj1 = new UnideskRtaAdAdgroupUpdateRequest.AdgroupTopDTODomain();
obj1.Smooth = 1L;
UnideskRtaAdAdgroupUpdateRequest.BudgetTopDTODomain obj2 = new UnideskRtaAdAdgroupUpdateRequest.BudgetTopDTODomain();
obj2.BudgetType = 1L;
obj2.Budget = 1L;
obj2.DayBudgets = new long[] { 50000 };
;
obj1.Budget= obj2;
obj1.CampaignId = 1L;
obj1.AdvertiserId = 1L;
UnideskRtaAdAdgroupUpdateRequest.AdgroupTargetTopDTODomain obj3 = new UnideskRtaAdAdgroupUpdateRequest.AdgroupTargetTopDTODomain();
UnideskRtaAdAdgroupUpdateRequest.AreaDTODomain obj4 = new UnideskRtaAdAdgroupUpdateRequest.AreaDTODomain();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain> list6 = new List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain obj7 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain();
list6.Add(obj7);
obj7.Name = "北京";
obj7.Value = "11";
obj4.City= list6;
obj4.CityTarget = 1L;
obj4.Type = 1L;
obj3.Area= obj4;
UnideskRtaAdAdgroupUpdateRequest.InterestActionDTODomain obj8 = new UnideskRtaAdAdgroupUpdateRequest.InterestActionDTODomain();
UnideskRtaAdAdgroupUpdateRequest.ActionCategorieDTODomain obj9 = new UnideskRtaAdAdgroupUpdateRequest.ActionCategorieDTODomain();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain> list11 = new List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain obj12 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain();
list11.Add(obj12);
obj12.Num = "11";
obj12.Name = "名称";
obj12.Value = "1";
obj9.ActionCategories= list11;
obj9.ActionScene = "1";
obj9.ActionDays = 1L;
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain> list14 = new List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain obj15 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain();
list14.Add(obj15);
obj15.Num = "1";
obj15.Name = "名称";
obj15.Value = "1";
obj9.Keywords= list14;
obj8.ActionCategorie= obj9;
UnideskRtaAdAdgroupUpdateRequest.InterestCategorieDTODomain obj16 = new UnideskRtaAdAdgroupUpdateRequest.InterestCategorieDTODomain();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain> list18 = new List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain obj19 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain();
list18.Add(obj19);
obj19.Num = "1";
obj19.Name = "名称";
obj19.Value = "1";
obj16.Keywords= list18;
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain> list21 = new List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain obj22 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain();
list21.Add(obj22);
obj22.Num = "1";
obj22.Name = "名称";
obj22.Value = "1";
obj16.InterestCategories= list21;
obj8.InterestCategorie= obj16;
obj8.Type = 1L;
obj3.InterestAction= obj8;
obj3.HideIfConverted = 1L;
obj3.NetCarrier = "1";
obj3.Career = "1";
obj3.Gender = 1L;
UnideskRtaAdAdgroupUpdateRequest.DeviceDTODomain obj23 = new UnideskRtaAdAdgroupUpdateRequest.DeviceDTODomain();
obj23.DeviceBrands = "1";
obj23.DevicePriceType = 1L;
obj23.DevicePrices = "0";
obj3.Device= obj23;
obj3.AutoExtendTargets = "1";
UnideskRtaAdAdgroupUpdateRequest.AgeDTODomain obj24 = new UnideskRtaAdAdgroupUpdateRequest.AgeDTODomain();
obj24.AgeRange = "1";
obj24.CustomAge = "18";
obj24.Type = 2L;
obj3.Age= obj24;
List<UnideskRtaAdAdgroupUpdateRequest.PlatformDTODomain> list26 = new List<UnideskRtaAdAdgroupUpdateRequest.PlatformDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.PlatformDTODomain obj27 = new UnideskRtaAdAdgroupUpdateRequest.PlatformDTODomain();
list26.Add(obj27);
obj27.Type = 1L;
obj27.AndroidVersion = 4L;
obj27.IosVersion = 1L;
obj3.Platform= list26;
UnideskRtaAdAdgroupUpdateRequest.ToutiaoAdgroupTargetTopDTODomain obj28 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoAdgroupTargetTopDTODomain();
obj28.UserActivateType = "1";
obj28.SuperiorPopularityType = 1L;
UnideskRtaAdAdgroupUpdateRequest.AwemeFanBehaviorDTODomain obj29 = new UnideskRtaAdAdgroupUpdateRequest.AwemeFanBehaviorDTODomain();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain> list31 = new List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain obj32 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain();
list31.Add(obj32);
obj32.Num = "1";
obj32.Name = "名称";
obj32.Value = "1";
obj29.Keywords= list31;
obj29.AwemeFanDays = 1L;
obj29.AwemeFanScene = "SHARED_USER";
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain> list34 = new List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain obj35 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain();
list34.Add(obj35);
obj35.Num = "1";
obj35.Name = "名称";
obj35.Value = "1";
obj29.AwemeFanCategories= list34;
obj28.AwemeFanBehavior= obj29;
obj3.Toutiao= obj28;
obj3.Network = "1";
UnideskRtaAdAdgroupUpdateRequest.KuaishouAdgroupTargetTopDTODomain obj36 = new UnideskRtaAdAdgroupUpdateRequest.KuaishouAdgroupTargetTopDTODomain();
List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain> list38 = new List<UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain obj39 = new UnideskRtaAdAdgroupUpdateRequest.CommonDTODomain();
list38.Add(obj39);
obj39.Name = "风景-风景";
obj39.Value = "2";
obj36.FansStar= list38;
obj36.IntelliTargetSwitch = 0L;
obj3.Kuaishou= obj36;
obj1.Target= obj3;
UnideskRtaAdAdgroupUpdateRequest.CastTimeTopDTODomain obj40 = new UnideskRtaAdAdgroupUpdateRequest.CastTimeTopDTODomain();
obj40.TimeSeries = "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111";
obj40.TimeType = 1L;
obj40.StartTime = DateTime.Parse(2022-08-25 00:00:00");
obj40.EndTime = DateTime.Parse(2022-08-25 00:00:00");
obj1.CastTime= obj40;
obj1.Name = "1";
UnideskRtaAdAdgroupUpdateRequest.AdgroupPricingTopDTODomain obj41 = new UnideskRtaAdAdgroupUpdateRequest.AdgroupPricingTopDTODomain();
obj41.Bid = 1L;
obj41.CpaBid = 1L;
obj41.AdjustCpa = 1L;
obj41.RoiGoal = "0.01";
obj1.Pricing= obj41;
obj1.Id = 1L;
UnideskRtaAdAdgroupUpdateRequest.LandingPageTopDTODomain obj42 = new UnideskRtaAdAdgroupUpdateRequest.LandingPageTopDTODomain();
obj42.DpLinkUrl = "tbopen://m.taobao.com/tbopen";
obj1.LandingPage= obj42;
UnideskRtaAdAdgroupUpdateRequest.ToutiaoAdgroupV2TopDTODomain obj43 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoAdgroupV2TopDTODomain();
UnideskRtaAdAdgroupUpdateRequest.ToutiaoPromotionIdentityV2TopDTODomain obj44 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoPromotionIdentityV2TopDTODomain();
obj44.PromotionType = 1L;
obj44.TalentId = "抖音达人ID";
obj44.IsHideVideo = 1L;
obj43.PromotionIdentity= obj44;
UnideskRtaAdAdgroupUpdateRequest.ToutiaoMediaCreativeGroupV2TopDTODomain obj45 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoMediaCreativeGroupV2TopDTODomain();
List<UnideskRtaAdAdgroupUpdateRequest.MediaMaterialTopDTODomain> list47 = new List<UnideskRtaAdAdgroupUpdateRequest.MediaMaterialTopDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.MediaMaterialTopDTODomain obj48 = new UnideskRtaAdAdgroupUpdateRequest.MediaMaterialTopDTODomain();
list47.Add(obj48);
obj48.Format = 1L;
obj48.CcMaterialId = "1";
obj48.Type = 1L;
UnideskRtaAdAdgroupUpdateRequest.VideoConverMaterialTopDTODomain obj49 = new UnideskRtaAdAdgroupUpdateRequest.VideoConverMaterialTopDTODomain();
obj49.CcMaterialId = "1";
obj48.VideoConverMaterial= obj49;
obj45.Materials= list47;
List<UnideskRtaAdAdgroupUpdateRequest.TextMaterialDTODomain> list51 = new List<UnideskRtaAdAdgroupUpdateRequest.TextMaterialDTODomain>();
UnideskRtaAdAdgroupUpdateRequest.TextMaterialDTODomain obj52 = new UnideskRtaAdAdgroupUpdateRequest.TextMaterialDTODomain();
list51.Add(obj52);
obj52.Content = "文案内容";
obj45.TitleMaterials= list51;
obj45.DeriveSwitch = 1L;
obj45.ActionTexts = "行动号召";
obj45.CreativeComponentId = 1L;
obj45.AnchorComponentId = 1L;
obj45.AnchorRelatedType = 1L;
obj43.MediaCreativeGroup= obj45;
UnideskRtaAdAdgroupUpdateRequest.ToutiaoProductionV2DTODomain obj53 = new UnideskRtaAdAdgroupUpdateRequest.ToutiaoProductionV2DTODomain();
obj53.Name = "产品名称";
obj53.MaterialIds = "1";
obj53.SellingPoints = "产品卖点";
obj43.Production= obj53;
obj43.AdSource = "广告来源";
obj43.CommentSwitch = 1L;
obj43.AdDownloadSwitch = 1L;
obj1.ToutiaoV2= obj43;
obj1.Version = 9999L;
req.AdgroupTopDto_ = obj1;
UnideskRtaAdAdgroupUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new UnideskRtaAdAdgroupUpdateRequest;
$req->setRequestId("1");
$adgroup_top_dto = new AdgroupTopDTO;
$adgroup_top_dto->smooth="1";
$budget = new BudgetTopDTO;
$budget->budget_type="1";
$budget->budget="1";
$budget->day_budgets="50000";
$adgroup_top_dto->budget = $budget;
$adgroup_top_dto->campaign_id="1";
$adgroup_top_dto->advertiser_id="1";
$target = new AdgroupTargetTopDTO;
$area = new AreaDTO;
$city = new CommonDTO;
$city->name="北京";
$city->value="11";
$area->city = $city;
$area->city_target="1";
$area->type="1";
$target->area = $area;
$interest_action = new InterestActionDTO;
$action_categorie = new ActionCategorieDTO;
$action_categories = new CommonDTO;
$action_categories->num="11";
$action_categories->name="名称";
$action_categories->value="1";
$action_categorie->action_categories = $action_categories;
$action_categorie->action_scene="1";
$action_categorie->action_days="1";
$keywords = new CommonDTO;
$keywords->num="1";
$keywords->name="名称";
$keywords->value="1";
$action_categorie->keywords = $keywords;
$interest_action->action_categorie = $action_categorie;
$interest_categorie = new InterestCategorieDTO;
$keywords = new CommonDTO;
$keywords->num="1";
$keywords->name="名称";
$keywords->value="1";
$interest_categorie->keywords = $keywords;
$interest_categories = new CommonDTO;
$interest_categories->num="1";
$interest_categories->name="名称";
$interest_categories->value="1";
$interest_categorie->interest_categories = $interest_categories;
$interest_action->interest_categorie = $interest_categorie;
$interest_action->type="1";
$target->interest_action = $interest_action;
$target->hide_if_converted="1";
$target->net_carrier="1";
$target->career="1";
$target->gender="1";
$device = new DeviceDTO;
$device->device_brands="1";
$device->device_price_type="1";
$device->device_prices="0";
$target->device = $device;
$target->auto_extend_targets="1";
$age = new AgeDTO;
$age->age_range="1";
$age->custom_age="18";
$age->type="2";
$target->age = $age;
$platform = new PlatformDTO;
$platform->type="1";
$platform->android_version="4";
$platform->ios_version="1";
$target->platform = $platform;
$toutiao = new ToutiaoAdgroupTargetTopDTO;
$toutiao->user_activate_type="1";
$toutiao->superior_popularity_type="1";
$aweme_fan_behavior = new AwemeFanBehaviorDTO;
$keywords = new CommonDTO;
$keywords->num="1";
$keywords->name="名称";
$keywords->value="1";
$aweme_fan_behavior->keywords = $keywords;
$aweme_fan_behavior->aweme_fan_days="1";
$aweme_fan_behavior->aweme_fan_scene="SHARED_USER";
$aweme_fan_categories = new CommonDTO;
$aweme_fan_categories->num="1";
$aweme_fan_categories->name="名称";
$aweme_fan_categories->value="1";
$aweme_fan_behavior->aweme_fan_categories = $aweme_fan_categories;
$toutiao->aweme_fan_behavior = $aweme_fan_behavior;
$target->toutiao = $toutiao;
$target->network="1";
$kuaishou = new KuaishouAdgroupTargetTopDTO;
$fans_star = new CommonDTO;
$fans_star->name="风景-风景";
$fans_star->value="2";
$kuaishou->fans_star = $fans_star;
$kuaishou->intelli_target_switch="0";
$target->kuaishou = $kuaishou;
$adgroup_top_dto->target = $target;
$cast_time = new CastTimeTopDTO;
$cast_time->time_series="111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111";
$cast_time->time_type="1";
$cast_time->start_time="2022-08-25 00:00:00";
$cast_time->end_time="2022-08-25 00:00:00";
$adgroup_top_dto->cast_time = $cast_time;
$adgroup_top_dto->name="1";
$pricing = new AdgroupPricingTopDTO;
$pricing->bid="1";
$pricing->cpa_bid="1";
$pricing->adjust_cpa="1";
$pricing->roi_goal="0.01";
$adgroup_top_dto->pricing = $pricing;
$adgroup_top_dto->id="1";
$landing_page = new LandingPageTopDTO;
$landing_page->dp_link_url="tbopen://m.taobao.com/tbopen";
$adgroup_top_dto->landing_page = $landing_page;
$toutiao_v2 = new ToutiaoAdgroupV2TopDTO;
$promotion_identity = new ToutiaoPromotionIdentityV2TopDTO;
$promotion_identity->promotion_type="1";
$promotion_identity->talent_id="抖音达人ID";
$promotion_identity->is_hide_video="1";
$toutiao_v2->promotion_identity = $promotion_identity;
$media_creative_group = new ToutiaoMediaCreativeGroupV2TopDTO;
$materials = new MediaMaterialTopDTO;
$materials->format="1";
$materials->cc_material_id="1";
$materials->type="1";
$video_conver_material = new VideoConverMaterialTopDTO;
$video_conver_material->cc_material_id="1";
$materials->video_conver_material = $video_conver_material;
$media_creative_group->materials = $materials;
$title_materials = new TextMaterialDTO;
$title_materials->content="文案内容";
$media_creative_group->title_materials = $title_materials;
$media_creative_group->derive_switch="1";
$media_creative_group->action_texts="行动号召";
$media_creative_group->creative_component_id="1";
$media_creative_group->anchor_component_id="1";
$media_creative_group->anchor_related_type="1";
$toutiao_v2->media_creative_group = $media_creative_group;
$production = new ToutiaoProductionV2DTO;
$production->name="产品名称";
$production->material_ids="1";
$production->selling_points="产品卖点";
$toutiao_v2->production = $production;
$toutiao_v2->ad_source="广告来源";
$toutiao_v2->comment_switch="1";
$toutiao_v2->ad_download_switch="1";
$adgroup_top_dto->toutiao_v2 = $toutiao_v2;
$adgroup_top_dto->version="9999";
$req->setAdgroupTopDto(json_encode($adgroup_top_dto));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.unidesk.rta.ad.adgroup.update' \
-d 'partner_id=apidoc' \
-d 'session=80cfe203-0179-4b6e-9a54-f9db5c6adfbf' \
-d 'sign=0464214B4868B6BBD53E1433804D48C2' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-26+07%3A38%3A41' \
-d 'v=2.0' \
-d 'adgroup_top_dto=null' \
-d 'request_id=1'

# -*- coding: utf-8 -*-
import top.api

req=top.api.UnideskRtaAdAdgroupUpdateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.request_id="1"
req.adgroup_top_dto="数据结构示例JSON格式"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.unidesk.rta.ad.adgroup.update");
add_param(pRequest,"request_id","1");
add_param(pRequest,"adgroup_top_dto","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.unidesk.rta.ad.adgroup.update', {
	'request_id':'1',
	'adgroup_top_dto':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<unidesk_rta_ad_adgroup_update_response>
    <result>
        <id>1</id>
    </result>
</unidesk_rta_ad_adgroup_update_response>

{
    "unidesk_rta_ad_adgroup_update_response":{
        "result":{
            "id":1
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

阿里妈妈-UniDesk

taobao.unidesk.rta.ad.adgroup.update (UD计划修改接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ