← 返回 API 列表 ← 项目门户

批量更新项目状态

关键信息详情
文档 ID1740941413906432
标签 ID34
原始文档[https://open.oceanengine.com/labels/34/docs/1740941413906432?origin=left_nav](https://open.oceanengine.com/labels/34/docs/1740941413906432?origin=left_nav)
接口标识ad.project.status.update
💡批量更新巨量引擎体验版营销项目的状态,不允许修改搜索周期稳投项目的操作状态。对于删除的营销项目不可进行任何操作,否则会报错。配合接口为【获取Access-Token】。 > 批量更新 巨量引擎体验版 营销项目的状态 不允许修改搜索周期稳投项目的操作状态(项目层级delivery_type = `DURATION`)
POST [https://api.oceanengine.com/open_api/v3.0/project/status/update/](https://api.oceanengine.com/open_api/v3.0/project/status/update/) 🔍 可视化调试 📦 SDK下载

接口说明

批量更新巨量引擎体验版营销项目的状态,不允许修改搜索周期稳投项目的操作状态。对于删除的营销项目不可进行任何操作,否则会报错。配合接口为【获取Access-Token】。

批量更新 巨量引擎体验版 营销项目的状态

不允许修改搜索周期稳投项目的操作状态(项目层级delivery_type = DURATION)

请求地址

https://api.oceanengine.com/open_api/v3.0/project/status/update/可视化调试SDK下载MCP调用

请求方式

POST Request-Body

请求Header

字段类型描述Content-Typestring请求消息类型,允许值:application/jsonAccess-Tokenstring授权Access-Token,获取方法见接口文档【获取Access-Token】

请求参数

基础参数

字段类型描述advertiser_id 必填number投放账户iddataobject[]批量更新项目状态,包含项目ID和目标操作,list长度限制1~10project_idnumber项目IDopt_statusstring目标操作,允许值: ENABLE 启用项目、 DISABLE 暂停项目
对于删除的营销项目不可进行任何操作,否则会报错

请求示例

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import okhttp3.*;
import org.apache.http.client.utils.URIBuilder;

应答参数

字段类型描述codenumber返回码,详见【附录-返回码】messagestring返回信息,详见【附录-返回码】datajsonjson返回值project_idsnumber[]更新成功的营销项目ID集合errorsobject[]更新失败的营销项目列表project_idnumber项目IDerror_messagestring错误信息request_idstring请求日志id

应答示例

HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {}
}
在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →