批量更新推广计划

HTTP请求方式

POST

请求地址

https://api.e.360.cn/display/campaign/Update

Headers 请求参数

字段	类型	必须	描述
Content-Type	string	yes	application/json
apiKey	string	yes	注册时分配到的api key，该参数作为HTTP HEAD字段传递。
accessToken	string	yes	访问token

Body 请求参数

请求参数通过JSON Array传参，一次操作计划数量不超过100个，任意层级同object的重复key以最后一个为准

字段	类型	必须	描述
campaignId	integer	yes	待修改的推广计划ID
campaignName	string	no	推广计划名称长度范围：[1字节：100字节]，字节计算参考UTF-8编码的字节长度；1个中文按3个字节计算，英文、数字、符号按1个字节计算注意：新建名称不能与同一账户下未删除的计划名称重复，不可输入敏感词；推广计划名称仅保留中间空格，首尾空格不保留
orderPrice	string	no	目标转化成本，仅在是否为oCPX计划为标准版oCPC、oCPM计划时生效取值范围：[0.5,max（账户预算, 100000)] ，支持填写不小于0.5的整数或2位小数，不传参或值为空表示不修改。
cpmPrice	string	no	CPM出价，仅在是否为oCPX计划为oCPM计划时生效取值范围：[0.1,max（账户预算, 100000)] ，支持填写不小于0.1的整数或2位小数，不传参或值为空表示不修改。
cpcPrice	string	no	CPC出价，仅在是否为oCPX计划为标准版oCPC时生效取值范围：[0.1,max（账户预算, 100000)] ，支持填写不小于0.1的整数或2位小数，不传参或值为空表示不修改。
orderUrl	string	no	转化成功页地址 URL，在是否为oCPX计划为否、或标准版oCPC、oCPM计划、放量投放计划的转化类型为快投放时生效最多输入5个url，需用英文逗号隔开，单个url长度不可超过512字节，不传参或值为空表示不修改。
accelerateConsumeFlag	string	no	一键起量，仅在是否为oCPX计划为标准版oCPC、oCPM计划时生效枚举值：0-关闭，1-开启，不传参或值为空表示不修改注意：如果重新开启一键起量，生效时间会向后顺延；例如2点开启一键起量，3点关闭，4点又开启，则一键起量生效时间会投到10点。
budget	string	no	每日预算在是否为oCPX计划为否时，取值范围：[50,Min(10000000, 账户预算)]，传0表示不限预算，不传参或值为空表示不修改在是否为oCPX计划为标准版oCPC、oCPM计划时，取值范围：[100,Min(10000000, 账户预算)]，传0表示不限预算，不传参或值为空表示不修改但当冷启动策略选择nobid时，不可选择不限预算；在是否为oCPX计划为放量投放计划时，取值范围：[100,Min(10000000, 账户预算)]，不可取0，不传参或值为空表示不修改。
equalBudgetFlag	string	no	预算分配控制，仅在是否为oCPX计划为否时，此字段生效枚举值：0-标准：将每日预算均匀地分配到整个投放日程中，1-尽速：在投放日程中尽可能地获得更多的展现（建议与精准定向配合使用），不传参或值为空表示不修改。
budgetLimitedAlert	string	no	预算受限提醒枚举值：0-否，1-是，不传参或值为空表示不修改。
auditRefusedWarnFlag	string	no	创意审核拒登提醒枚举值：0-否，1-是，不传参或值为空表示不修改。
startDate	date	no	推广计划开始日期日期输入格式：YYYY-MM-DD，例如2023-12-31，输入日期不能早于当日，不能晚于2030-12-31，不传参或值为空表示不修改
endDate	date	no	推广计划结束日期日期输入格式：YYYY-MM-DD 不能早于开始日期，不能晚于2030-12-31，不传参或值为空表示不修改
weekHours	object	yes	按小时投放日程，json格式，Week字段1-7表示周一至周日，hour总数为48，其中0为此时段不投放，1为投放，全天不投放也需填写，整周至少投放任一时段，不传参或值为空表示不修改例:[{"week":1,"hour":[1,1,1,1,1,1,1,1,1,1……]},{"week":2,"hour": [0,0,0,0,0,0,0,0,0,0……]},{"week":3,"hour": [1,0,1,1,1,0,1,1,1,1……]}……]每周二不投放。

请求示例

curl --location --request POST 'http://localhost:8076/display/campaign/update' \
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--header 'Content-Type: application/json' \
--data-raw '[{
    "campaignId":5013389,
    "campaignName":"改个名字看看"
}]'

返回结果

{
  "data": [
    {
      "id": 5013489,
      "errno": 2000000,
      "message": "成功"
    }
  ],
  "errmsg": "OK",
  "errno": 0
}

返回结果说明

字段	类型	描述
id	string	修改的推广计划的id

results matching ""

No results matching ""