更新推广计划
全部接口
V1.1
loading
V1.1
loading
| 所属权限 | Ads Management |
| 请求地址 | campaigns/update |
| 请求方法 | post |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。
| 参数名称 | 参数类型 |
|---|---|
| access_token | 授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节 |
| timestamp |
当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59 |
| nonce | 随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性 |
| fields | get 接口增加 fields 字段，用于指定返回参数的字段列表，为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写，则根据默认值进行返回 |
请求参数
标有*的参数为必填项
| 名称 | 类型 | 描述 |
|---|---|---|
|
account_id*
|
integer | 广告主帐号 id，有操作权限的帐号 id，不支持代理商 id |
|
campaign_id*
|
int64 | 推广计划 id |
|
campaign_name
|
string | 推广计划名称，字段长度最小 1 个等宽字符，长度最大 60 等宽字符（即字段最大长度为 60 个中文字或全角标点，120 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。） |
|
daily_budget
|
integer | 推广计划日预算，单位为分，设置为 0 表示不设预算（即不限）， 日预算要求介于 5,000 分– 4,000,000,000 分之间（50 元-40,000,000 元，单位为人民币） 当推广计划下有微信朋友圈广告（campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS 或 site_set=SITE_SET_MOMENTS）： 当推广计划下为非微信朋友圈广告（campaign_type!=CAMPAIGN_TYPE_WECHAT_MOMENTS 且 site_set!=SITE_SET_MOMENTS）： |
|
total_budget
|
integer | 推广计划总预算，单位为分，设置为 0 表示不设预算（即不限）， 总预算需介于 5,000 分-4,000,000,000 分之间（50 元-40,000,000 元，单位为人民币）； 修改后的总预算不能低于该计划累计总消耗金额加上今日已消耗金额的 0.5 倍，且不能低于当前计划累计总消耗金额加上 50,000 分（500 元，单位为人民币）； 每次修改幅度不能低于 5,000 分（50 元，单位为人民币）； 允许从不限预算（0）修改为指定预算，以及从指定总预算修改为不限预算（0）； 每天每计划最多修改 1,000 次 最小值 0，最大值 4000000000 |
|
configured_status
|
enum | 客户设置的状态，[枚举详情] 枚举列表：{ AD_STATUS_NORMAL, AD_STATUS_SUSPEND } |
|
speed_mode
|
enum | 投放速度模式，默认值为标准投放，[枚举详情] 枚举列表：{ SPEED_MODE_FAST, SPEED_MODE_STANDARD } |
使用说明
- CAMPAIGN_TYPE_WECHAT_MOMENTS 已废弃，可切换使用 CAMPAIGN_TYPE_NORMAL。
请求示例
curl 'https://api.e.qq.com/v1.1/campaigns/update?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'campaign_id=<CAMPAIGN_ID>' \
-d 'campaign_name=五一节大促推广计划' \
-d 'daily_budget=50000' \
-d 'configured_status=AD_STATUS_SUSPEND' \
-d 'speed_mode=SPEED_MODE_STANDARD'
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
|
campaign_id
|
int64 | 推广计划 id |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"campaign_id": "<CAMPAIGN_ID>"
}
}可视化调试工具
相关阅读
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
