← 返回项目列表

升级版巨量引擎工作台 - MarketingAPI

更新日志

更新日期通知类型接口path接口名称改动字段改动说明（字段标黄表示新增字段）
2026.03.25重要通知/open_api/v3.0/file/ebp_video/get/获取账户可用的组织视频列表新增接口
2026.01.28重要通知/open_api/v3.0/tools/ebp/video/upload/升级版工作台上传视频新增接口新增支持EBP维度视频素材相关管理接口
/open_api/v3.0/tools/ebp/video/update/升级版工作台更新视频信息
/open_api/v3.0/tools/ebp/video/delete/升级版工作台批量删除视频
/open_api/v3.0/tools/ebp/material/auth/create/升级版工作台素材共享设置
/open_api/v3.0/tools/ebp/material/auth/list/升级版工作台查询素材共享范围
/open_api/v3.0/tools/ebp/material/auth/delete/升级版工作台取消素材共享
/open_api/v3.0/tools/ebp/video_attributes/list/升级版工作台获取视频素材评估标签
2025.10.31重要通知商品管理、应用管理、小程序&游戏管理新增接口新增支持ebp维度相关管理接口
2025.06.09重要通知/open_api/2/ebp/level/get/获取工作台组织关系（升级版）新增接口实时获取工作台组织关系以及组织下管理账户列表
/open_api/2/ebp/advertiser/list/获取工作台组织下账户列表（升级版）
/open_api/2/ebp/advertiser/task/create/创建获取工作台组织账户任务通过异步任务方式针对账户量级过大的业务场景获取账户列表
/open_api/2/ebp/advertiser/task/list/查询获取工作台组织账户任务状态
/open_api/2/ebp/advertiser/task/download/下载获取工作台组织账户任务结果

产品介绍

基于巨量引擎升级版工作台产品能力，[巨量引擎开放平台](https://open.oceanengine.com/)提供了对应的接口服务，支持您调用Marketing API针对升级后的新版账户体系关系获取及高效管理。

🥇

升级版工作台和旧版工作台产品能力对比：

在做API接口改造前，请先进入巨量工作台平台，进行升级版开通，开通及升级路径参考下图。

巨量工作台登录地址：https://business.oceanengine.com/login?appKey=51

![图片展示了巨量引擎工作台升级版开通及升级路径。分为升级版组织开通&认证、搭建组织、导入账户、添加/导入成员、导入资产、导入素材六个步骤。其中，升级版组织开通&认证需选择一个旧版工作台进行升级并完成认证；搭建组织可在升级版工作台搭建组织架构；导入账户可将旧版工作台内投放账户导入升级版；添加/导入成员可将旧版工作台成员导入升级版；导入资产可将需使用的资产导入升级版；导入素材可将需管理的素材导入升级版。最后是资产/账户导入，需完成搭建组织环节。](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=OTU1MmM4MWIzNDBhY2Y1NzljOWU5NzUwNDJiMDBjZWZfYzBkNzFhYTUxOTk3NmVlYTBmZmE5ODZhNWY3NGY0OTFfSUQ6NzU3MTM3MTA0MDkwODMyODk4OF8xNzg0ODgzMTk2OjE3ODQ4ODY3OTZfVjM)

如何使用API获取升级版工作台账户？

使用前提

调用开放平台提供的API接口能力前,需要先注册成为巨量引擎开放平台开发者。

入驻成为开发者

在使用Marketing API接口功能前，需要先注册成为开发者，建议使用公司邮箱进行注册并妥善管理。

注册认证流程可参考：【[注册成为开发者](https://open.oceanengine.com/labels/41/docs/1746489101948942)】

📌

一个公司主体信息只能注册认证一个开发者账户，认证通过后不支持修改(仅支持企业类型认证)

创建开发者应用

应用根据业务场景分为【巨量广告】和【巨量千川】，不同业务场景对应接入能力范围不同，每个业务场景下最多可创建10个应用。

> 不同应用场景对应支持权限范围不同，可参考图表 2-1

类型应用场景客户类型/产品形态应用权限范围
基础应用自研投放系统广告主除【代理商账号管理】类接口
代理商客户除【纵横组织管理】类接口
服务市场应用提供第三方服务三方服务站点除【广告主信息与资质管理(除"广告主公开信息"接口)】、【代理商账号管理-创建和修改广告主】、【代理商账号管理-资金和流水管理】类接口
图表 2-1

详细创建应用流程可参考：【[如何创建应用程序并申请权限](https://open.oceanengine.com/labels/41/docs/1812506224501113)】

申请授权并获取Token

操作业务接口能力前，需要开发者向业务账户持有人申请授权并获取对应AccessToken后，才可以获取到可操作账户并请求相关业务接口

❗

1. 素材属于敏感物料信息，如开发者认证使用的主体信息（公司信息）与业务账号所属主体不一致，授权时同时需要申请敏感物料授权（可参考下方详情流程中的介绍）

2. 授权页面登录多个账号分别完成授权，需要分别记录对应生成Token，具体Token与授权账户关系介绍可参考：【[如何获取Token并维持效期](https://open.oceanengine.com/labels/41/docs/1812506522148059)】

详细申请授权流程可参考：【[如何申请授权](https://open.oceanengine.com/labels/41/docs/1812506430648330)】

获取已授权管理账户

授权完成后，即可开始进行业务接口接入调试，需要先根据接口确认已授权可操作账户范围

在完成授权并得到Token后，可通过【[获取已授权账号](https://open.oceanengine.com/labels/37/docs/1696710506574848)】接口查询AccessToken下具体授权的账号信息

📌

【[获取已授权账号](https://open.oceanengine.com/labels/37/docs/1696710506574848)】接口返回account_role账户角色PLATFORM_ROLE_ENTERPRISE_BP_ADMIN 工作台管理员（升级版）、PLATFORM_ROLE_ENTERPRISE_BP_OPERATOR 工作台协作者（升级版），为升级版工作台账户下管理角色

模块接口文档地址详细说明
升级版工作台获取工作台组织关系（升级版）可根据【获取已授权账号】查询到的工作台（升级版）相关管理员/协作者对应账户ID，查询对应账户下组织关系，以及相关组织下管理业务账户列表
获取工作台组织下账户列表（升级版）
创建获取工作台组织账户任务在组织下账户量级过大（超过1W）时，可通过异步任务创建获取管理业务账户列表内容。
查询获取工作台组织账户任务状态
下载获取工作台组织账户任务结果

升级版工作台相关接口功能

素材管理

💡

支持获取EBP维度分享素材内容，暂时不支持通过接口管理（上传、修改、删除等操作）EBP维度素材内容

  • 上传、修改等能力可关注后续更新通知
模块接口文档地址接口路径详细说明
素材管理获取账户可用的组织视频列表/open_api/v3.0/file/ebp_video/get/新增接口
支持获取广告账户中被EBP共享视频素材内容
获取视频素材/open_api/2/file/video/get/不支持获取通过EBP共享的素材内容
获取视频智能封面/open_api/2/tools/video_cover/suggest/逻辑变动
    • 增加支持使用EBP共享的视频素材获取封面图片
获取同主体下广告主视频素材/open_api/2/file/video/ad/get/不支持获取通过EBP共享的素材内容
素材推送/open_api/2/file/material/bind/不支持操作通过EBP共享的素材内容
批量删除视频素材/open_api/v3.0/file/video/delete/
更新视频/open_api/2/file/video/update/
获取视频素材评估标签（新版）/open_api/2/file/material_attributes/list/不支持EBP维度的视频素材信息查询
升级版工作台上传视频/open_api/v3.0/tools/ebp/video/upload/新增接口，支持EBP维度视频素材相关操作
升级版工作台更新视频信息/open_api/v3.0/tools/ebp/video/update/
升级版工作台批量删除视频/open_api/v3.0/tools/ebp/video/delete/
升级版工作台素材共享设置/open_api/v3.0/tools/ebp/material/auth/create/
升级版工作台查询素材共享范围/open_api/v3.0/tools/ebp/material/auth/list/
升级版工作台取消素材共享/open_api/v3.0/tools/ebp/material/auth/delete/
升级版工作台获取视频素材评估标签/open_api/v3.0/tools/ebp/video_attributes/list/
橙子建站获取橙子建站站点列表

即将更新上线

/open_api/2/tools/site/get/新增参数
    • filtering 增加筛选EBP共享来源内容
组件管理查询组件列表

即将更新上线

/open_api/2/assets/creative_component/get/新增参数
    • filtering 增加筛选EBP共享来源内容
原生锚点获取原生锚点列表/open_api/v3.0/native_anchor/get/新增参数
    • filtering.source 增加筛选EBP共享来源内容
      • GROUP 组织维度

资金管理

💡

原有接口请求参数organization_id同时适配bp和ebp账户入参

模块接口文档地址接口路径详细说明
资金流水管理工作台转账-查询转账单信息/open_api/v3.0/cg_transfer/transfer_detail/get/逻辑变动
    • organization_id 同时支持传入bp/ebpid
工作台转账-获取可转列表/open_api/v3.0/cg_transfer/can_transfer_target/list/
工作台转账-查询账户转账余额/open_api/v3.0/cg_transfer/transfer_balance/get/
工作台转账-获取最大可转余额/open_api/v3.0/cg_transfer/can_transfer_balance/get/
工作台转账-发起转账/open_api/v3.0/cg_transfer/transfer/create/

资产共享范围管理

模块接口文档地址接口路径详细说明
升级版工作台查询资产共享范围/open_api/v3.0/tools/ebp/asset/auth/list/新增接口
支持EBP账户针对不同类型库、如商品库、应用库、事件管理等，查询设置内容共享组织范围
取消资产共享/open_api/v3.0/tools/ebp/asset/auth/cancel/
添加资产共享/open_api/v3.0/tools/ebp/asset/auth/

资产管理

💡

ebp维度相关资产管理操作需接入新版接口，旧版接口仅支持adv以及bp维度操作

  • 接口中以adv维度入参查询包含对应adv被ebp共享资源内容

商品管理

模块接口文档地址接口路径详细说明
商品管理获取升级版商品列表/open_api/2/dpa/clue_product/list/新增枚举
    • filtering.rels 新增枚举参数
      • REL_EBP_COP EBP直属团队被共享的
      • REL_EBP_OWN EBP直属团队创建的
获取商品库信息/open_api/2/dpa/product/availables/增加支持获取EBP共享商品库内容
查询短剧商品原片授权申请状态/open_api/v3.0/dpa/ebp/playlet/auth/get/新增接口
支持EBP账户维度对商品库进行相关业务操作
获取商品库DPA词包/open_api/v3.0/dpa/ebp/dict/get/
获取商品库DPA分类/open_api/v3.0/dpa/ebp/category/get/
获取升级版商品详情/open_api/v3.0/dpa/ebp/clue_product/get/
获取通用版商品详情/open_api/v3.0/dpa/ebp/product/detail/get/
获取通用版商品列表/open_api/v3.0/dpa/ebp/product/list/
获取商品库元信息/open_api/v3.0/dpa/ebp/meta/get/
获取商品库列表/open_api/v3.0/dpa/ebp/library/list/
获取升级版商品列表/open_api/v3.0/dpa/ebp/clue_product/list/
删除升级版商品/open_api/v3.0/dpa/ebp/clue_product/delete/
批量修改DPA商品状态/open_api/v3.0/dpa/ebp/product_status/batch_update/
删除通用版商品/open_api/v3.0/dpa/ebp/product/delete/
编辑通用版商品库商品/open_api/v3.0/dpa/ebp/product/update/
创建/编辑升级版商品/open_api/v3.0/dpa/ebp/clue_product/save/
新建通用版商品/open_api/v3.0/dpa/ebp/product/create/

应用管理/小程序&游戏管理

模块接口文档地址接口路径详细说明
小程序小游戏管理获取字节小程序列表/open_api/v3.0/tools/ebp/micro_applet/list/新增接口
支持EBP账户维度对小游戏/小程序进行相关业务操作
获取字节小程序详情/open_api/v3.0/tools/ebp/micro_applet/link/list/
新建字节小程序/open_api/v3.0/tools/ebp/micro_applet/create/
更新字节小程序/open_api/v3.0/tools/ebp/micro_applet/update/
获取微信小程序列表/open_api/v3.0/tools/ebp/wechat_applet/list/
获取微信小游戏列表/open_api/v3.0/tools/ebp/wechat_game/list/
新建微信小程序/open_api/v3.0/tools/ebp/wechat_applet/create/
更新微信小程序/open_api/v3.0/tools/ebp/wechat_applet/update/
新建微信小游戏/open_api/v3.0/tools/ebp/wechat_game/create/
更新微信小程序/open_api/v3.0/tools/ebp/wechat_game/update/
获取字节小游戏列表/open_api/v3.0/tools/ebp/micro_game/list/
获取字节小游戏详情/open_api/v3.0/tools/ebp/micro_game/link/list/
新增字节小游戏/open_api/v3.0/tools/ebp/micro_game/create/
更新字节小游戏/open_api/v3.0/tools/ebp/micro_game/update/
应用管理获取安卓应用列表/open_api/v3.0/tools/ebp/app/list/新增接口
支持EBP账户维度对应用进行相关业务操作
查询安卓应用母包详情/open_api/v3.0/tools/ebp/app/detail/
查询安卓应用分包列表/open_api/v3.0/tools/ebp/app_extend/list/
发布安卓应用母包/open_api/v3.0/tools/ebp/app/publish/
更新安卓应用母包/open_api/v3.0/tools/ebp/app/update/
获取游戏预约列表/open_api/v3.0/tools/ebp/app_game_book/list/
创建安卓应用分包/open_api/v3.0/tools/ebp/app_extend/create/
更新安卓应用分包/open_api/v3.0/tools/ebp/app_extend/update/
在接这个接口时卡住了？
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 每日平台更新简报 →