---
id: "990bc8e366ab6f94f6d6"
url: "https://www.xmcsl.cn/project/ocean-engine-api/%E6%89%B9%E9%87%8F%E6%9B%B4%E6%96%B0%E9%A1%B9%E7%9B%AE%E7%8A%B6%E6%80%81-1740941413906432.html"
source_url: "https://open.oceanengine.com/labels/34/docs/1740941413906432?origin=left_nav"
source_date: null
checked_at: "2026-11-05T04:21:48.909937+00:00"
status: "ready"
check_scope: "structure_only; not a factual or human review"
body_sha256: "92d6cb15161e5a147e5392da0f0641ed0e975147fb2c8d57c7c1cd92c2ae80bd"
---

# 批量更新项目状态 — 巨量引擎 API

# 批量更新项目状态

 

<table><tr><th>关键信息</th><th>详情</th></tr><tr><th>文档 ID</th><td>1740941413906432</td></tr>&#10;<tr><th>标签 ID</th><td>34</td></tr>&#10;<tr><th>原始文档</th><td>&#91;https://open.oceanengine.com/labels/34/docs/1740941413906432?origin=left&#95;nav&#93;(https://open.oceanengine.com/labels/34/docs/1740941413906432?origin=left&#95;nav)</td></tr>&#10;<tr><th>接口标识</th><td>ad.project.status.update</td></tr>&#10;</table>

 

💡批量更新巨量引擎体验版营销项目的状态，不允许修改搜索周期稳投项目的操作状态。对于删除的营销项目不可进行任何操作，否则会报错。配合接口为【获取Access\-Token】。 &gt; 批量更新 巨量引擎体验版 营销项目的状态 不允许修改搜索周期稳投项目的操作状态（项目层级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/) <a href="https://open.oceanengine.com/tools/visual_debug.html?docId=1740941413906432">🔍 可视化调试</a> <a href="https://open.oceanengine.com/labels/7/docs/1773083358100557">📦 SDK下载</a>

 

## 接口说明

 

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

 

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

 

不允许修改搜索周期稳投项目的操作状态（项目层级delivery\_type = <code>DURATION</code>)

 

## 请求地址

 

<a href="https://api.oceanengine.com/open_api/v3.0/project/status/update/">https://api.oceanengine.com/open&#95;api/v3.0/project/status/update/</a><a href="https://open.oceanengine.com/tools/visual_debug.html?docId=1740941413906432">可视化调试</a><a href="https://open.oceanengine.com/labels/7/docs/1773083358100557">SDK下载</a><a href="https://open.oceanengine.com/labels/7/docs/1847394521222599">MCP调用</a>

 

## 请求方式

 

<strong>POST Request-Body</strong>

 

## 请求Header

 

字段类型描述Content\-Typestring请求消息类型，允许值：<code>application/json</code>Access\-Tokenstring授权Access\-Token，获取方法见接口文档【<a href="https://open.oceanengine.com/doc/index.html?key=ad&amp;type=api&amp;id=1696710505596940">获取Access-Token</a>】

 

## 请求参数

 

### 基础参数

 

字段类型描述advertiser\_id 必填number投放账户iddataobject\[\]批量更新项目状态，包含项目ID和目标操作，list长度限制1～10project\_idnumber项目IDopt\_statusstring目标操作，允许值： <code>ENABLE</code> 启用项目、 <code>DISABLE</code> 暂停项目  
对于删除的营销项目不可进行任何操作，否则会报错

 

## 请求示例

 

```plain
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

 

## 应答示例

 

```plain
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {}
}
```