文档中心 > API类目 > 阿里妈妈-UniDesk

taobao.unidesk.rta.ad.raise.update (一键起量-开启/预约)

一键起量-开启/预约

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
adgroup_raise_top_dto AdgroupRaiseTopDTO 必须 起量参数
  • └ advertise_id
  • Number
  • 必须
  • 1
  • 广告主id
  • └ adgroup_id
  • Number
  • 必须
  • 1
  • 计划id 只支持字节2.0
  • toutiao_raise_info_v2
  • ToutiaoV2AdgroupRaiseTopDto []
  • 可选
  • {}
  • 起量信息
  • └ raise_budget
  • Number
  • 可选
  • 1
  • 起量预算,单位分
  • └ effective
  • Number
  • 可选
  • 1
  • 是否立即生效,仅支持广告状态为“投放中”的广告,仅支持1个方案设置“立即生效”
  • └ repeated_day
  • String []
  • 可选
  • [EVERY_DAY]
  • 重复周期,仅生效一次。不传则不重复,传入EVERY_DAY则每天重复 允许值:PER_MONDAY;PER_TUESDAY;PER_WEDNESDAY;PER_THURSDAY;PER_FRIDAY:PER_SATURDAY;PER_SUNDAY; EVERY_DAY EVERY_DAY和其他允许值不可同时传入
  • └ raise_time
  • String
  • 可选
  • 2023-01-01 00:00
  • 起量时间 重复周期不传时,格式为yyyy-mm-dd HH:MM 传重复周期时,格式为HH:MM

响应参数

名称 类型 示例值 描述
result Boolean true 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaAdRaiseUpdateRequest req = new UnideskRtaAdRaiseUpdateRequest();
UnideskRtaAdRaiseUpdateRequest.AdgroupRaiseTopDTO obj1 = new UnideskRtaAdRaiseUpdateRequest.AdgroupRaiseTopDTO();
obj1.setAdvertiseId(1L);
obj1.setAdgroupId(1L);
List<UnideskRtaAdRaiseUpdateRequest.ToutiaoV2AdgroupRaiseTopDto> list3 = new ArrayList<UnideskRtaAdRaiseUpdateRequest.ToutiaoV2AdgroupRaiseTopDto>();
UnideskRtaAdRaiseUpdateRequest.ToutiaoV2AdgroupRaiseTopDto obj4 = new UnideskRtaAdRaiseUpdateRequest.ToutiaoV2AdgroupRaiseTopDto();
list3.add(obj4);
obj4.setRaiseBudget(1L);
obj4.setEffective(1L);
obj4.setRepeatedDay("EVERY_DAY");
obj4.setRaiseTime("2023-01-01 00:00");
obj1.setToutiaoRaiseInfoV2(list3);
req.setAdgroupRaiseTopDto(obj1);
UnideskRtaAdRaiseUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<unidesk_rta_ad_raise_update_response>
    <result>true</result>
</unidesk_rta_ad_raise_update_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部