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

taobao.unidesk.rta.ad.adgroup.budget.suggest (UD计划获取建议日预算及预期成本接口)

UD计划获取建议日预算及预期成本接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
adgroup_top_dto AdgroupTopDTO 必须 入参
  • └ smooth
  • Number
  • 必须
  • 1
  • 投放, 1 - 加速投放;2 - 平滑投放;3-优先低成本(投放时间范围只可为全天;预算不可为不限或空)
  • budget
  • BudgetTopDTO
  • 必须
  • 预算
  • └ budget_type
  • Number
  • 必须
  • 1
  • 预算类型 -1:不限、1:指定预算(每天预算相同)
  • └ budget
  • Number
  • 必须
  • 1
  • 统一预算金额,单位:分
  • └ campaign_id
  • Number
  • 必须
  • 1
  • 计划组id
  • └ advertiser_id
  • Number
  • 必须
  • 1
  • 广告主id
  • cast_time
  • CastTimeTopDTO
  • 必须
  • castTime
  • 投放周期
  • └ time_type
  • Number
  • 必须
  • 1
  • 投放周期类型,0:从今天起长期投放,1:设置开始和结束日期
  • pricing
  • AdgroupPricingTopDTO
  • 必须
  • pricing
  • 付费出价
  • └ pricing_type
  • Number
  • 必须
  • 1
  • 付费方式,2:CPM,3:CPC,5:OCPM,6:OCPC
  • └ bid_type
  • Number
  • 必须
  • 1
  • 出价方式:0:手动(默认),1:自动

响应参数

名称 类型 示例值 描述
result AdgroupBuddgetSuggestTopDTO 返回结果
  • └ min_smart_bid
  • Number
  • 2579
  • 建议出价最小值,单位分
  • └ max_budget
  • Number
  • 500100
  • 建议日预算最大值,单位分
  • └ max_smart_bid
  • Number
  • 2850
  • 建议出价最大值,单位分
  • └ min_budget
  • Number
  • 51800
  • 建议日预算最小值,单位分
  • └ suggest_budget
  • Number
  • 4999
  • 建议出价,单位分

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UnideskRtaAdAdgroupBudgetSuggestRequest req = new UnideskRtaAdAdgroupBudgetSuggestRequest();
UnideskRtaAdAdgroupBudgetSuggestRequest.AdgroupTopDTO obj1 = new UnideskRtaAdAdgroupBudgetSuggestRequest.AdgroupTopDTO();
obj1.setSmooth(1L);
UnideskRtaAdAdgroupBudgetSuggestRequest.BudgetTopDTO obj2 = new UnideskRtaAdAdgroupBudgetSuggestRequest.BudgetTopDTO();
obj2.setBudgetType(1L);
obj2.setBudget(1L);
obj1.setBudget(obj2);
obj1.setCampaignId(1L);
obj1.setAdvertiserId(1L);
UnideskRtaAdAdgroupBudgetSuggestRequest.CastTimeTopDTO obj3 = new UnideskRtaAdAdgroupBudgetSuggestRequest.CastTimeTopDTO();
obj3.setTimeType(1L);
obj1.setCastTime(obj3);
UnideskRtaAdAdgroupBudgetSuggestRequest.AdgroupPricingTopDTO obj4 = new UnideskRtaAdAdgroupBudgetSuggestRequest.AdgroupPricingTopDTO();
obj4.setPricingType(1L);
obj4.setBidType(1L);
obj1.setPricing(obj4);
req.setAdgroupTopDto(obj1);
UnideskRtaAdAdgroupBudgetSuggestResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<unidesk_rta_ad_adgroup_budget_suggest_response>
    <result>
        <min_smart_bid>2579</min_smart_bid>
        <max_budget>500100</max_budget>
        <max_smart_bid>2850</max_smart_bid>
        <min_budget>51800</min_budget>
        <suggest_budget>4999</suggest_budget>
    </result>
</unidesk_rta_ad_adgroup_budget_suggest_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

返回
顶部