接口文档SDK业务专题开发者工具

接口清单

本节将为您介绍 Marketing API 中涉及的接口信息,具体接口清单如下所示:

模块 接口 描述 所属权限(scope)
OAuth授权 oauth/authorize 获取Authorization Code
Account Management
Ads Management
Ads Insights
Audience Management
User Actions
oauth/token 获取Token
Account Management
Ads Management
Ads Insights
Audience Management
User Actions
绑定微信公众号 authorization/wechat_bind 绑定微信公众号(待废弃)
Ads Management
广告帐号 advertiser/add 添加腾讯广告服务商子客
Account Management
advertiser/update 更新腾讯广告广告主信息
Account Management
advertiser/get 查询腾讯广告广告主信息
Account Management
Ads Management
Ads Insights
Audience Management
User Actions
advertiser_daily_budget/get 查询腾讯广告账户日预算
Account Management
business_manager_relations/get 查询商务管家账号下广告主信息
Account Management
Ads Management
Ads Insights
Audience Management
User Actions
business_mdm_account_relations/get 查询商务管家或同主体下广告主信息
Account Management
Ads Management
Ads Insights
Audience Management
User Actions
资质 qualifications/add 创建广告主资质
Account Management
qualifications/update 更新广告主资质
Account Management
qualifications/get 获取广告主资质
Account Management
qualifications/delete 删除广告主资质
Account Management
资金账户 fund_transfer/add 发起代理商与子客户之间的转账
Account Management
funds/get 获取资金账户信息
Account Management
daily_balance_report/get 获取资金账户日结明细(新)
Account Management
fund_statements_detailed/get 获取资金账户流水
Account Management
realtime_cost/get 获取腾讯广告平台账号体系的实时消耗余额
Ads Management
agency_realtime_cost/get 获取服务商实时消耗
Account Management
subcustomer_transfer/add 同商务管家子客间转账
Account Management
merge_fund_type_subcustomer_transfer/add 资金合并类型同商务管家子客间转账
Account Management
merge_fund_type_funds/get 获取资金合并类资金账户信息
Account Management
merge_fund_type_daily_balance_report/get 获取资金合并类资金账户日结明细
Account Management
merge_fund_type_fund_statements_detailed/get 获取资金合并类型资金流水
Account Management
推广目标 promoted_objects/add 创建推广目标
Ads Management
promoted_objects/update 更新推广目标
Ads Management
promoted_objects/get 获取推广目标
Ads Management
Ads Insights
promoted_objects/delete 删除推广目标
Ads Management
Ads Insights
promoted_object_authorization/add 推广目标授权
Ads Management
Ads Insights
promoted_object_authorization/get 推广目标授权记录查询
Ads Management
Ads Insights
app_android_channel_packages/get 获取推广渠道包
Ads Management
落地页 pages/get 获取落地页列表
Ads Management
xijing_template_list/get 蹊径-获取模板列表
Ads Management
xijing_template/get 蹊径-获取落地页指定模板
Ads Management
xijing_complex_template/get 蹊径-获取落地页互动模板配置
Ads Management
xijing_page_list/get 蹊径-查询落地页列表
Ads Management
xijing_page/add 蹊径-基于模板创建落地页
Ads Management
xijing_page_by_components/add 蹊径-基于组件创建落地页
Ads Management
xijing_page_interactive/add 蹊径-创建互动落地页
Ads Management
xijing_page/update 蹊径-落地页送审
Ads Management
xijing_page/delete 蹊径-删除落地页
Ads Management
xijing_derive_role/get 蹊径-衍生-生成虚拟人
Ads Management
xijing_derive_click_effect/get 蹊径-衍生-生成点击特效
Ads Management
xijing_derive_temp_token/get 蹊径-衍生-获取临时token
Ads Management
短剧售卖策略 landing_page_sell_strategy/get 短剧售卖策略-查询售卖策略列表
Ads Management
landing_page_sell_strategy/add 短剧售卖策略-创建售卖策略
Ads Management
落地页号码包 wx_package_package/get 蹊径-获取号码包列表
Ads Management
wx_package_package/add 蹊径-添加号码包
Ads Management
wx_package_package/update 蹊径-修改号码包信息
Ads Management
wx_package_account/get 蹊径-获取微信号列表
Ads Management
wx_package_account/update 蹊径-修改微信号信息
Ads Management
视频 videos/add 添加视频文件
Ads Management
videos/get 获取视频信息
Ads Management
videos/update 修改视频信息
Ads Management
videos/delete 删除视频
Ads Management
图片 images/add 添加图片文件
Ads Management
Account Management
images/get 获取图片信息
Ads Management
Account Management
images/update 修改图片名字
Ads Management
Account Management
images/delete 删除图片
Ads Management
Account Management
品牌形象 brand/add 创建品牌形象
Ads Management
Account Management
brand/get 获取品牌形象列表
Ads Management
Account Management
互动推广页 playable_pages/add 添加互动推广页(待废弃)
Ads Management
playable_pages/get 获取互动推广页
Ads Management
商品库 product_catalogs/add 创建商品库
Ads Management
product_catalogs/get 获取商品库
Ads Management
product_items/add 添加商品
Ads Management
product_items_verticals/get 获取行业列表
Ads Management
product_items/get 获取商品
Ads Management
product_items_detail/get 获取商品详情
Ads Management
product_items/update 更新商品信息
Ads Management
product_items/batch_update 批量更新商品信息
Ads Management
products_system_status/get 获取审核失败的商品
Ads Management
product_categories_list/get 获取商品类目
Ads Management
product_series/add 添加商品系列
Ads Management
product_series/get 获取商品系列
Ads Management
动态商品图片 dynamic_ad_images/add 根据DPA模板生成图片
Ads Management
dynamic_ad_images/get 获取DPA模板生成的图片
Ads Management
动态商品视频 dynamic_ad_video/add 根据DPA模板生成视频
Ads Management
dynamic_ad_video/get 获取DPA模板生成的视频
Ads Management
微信原生页 wechat_pages/add 基于模板创建微信原生页
Ads Management
wechat_pages_custom/add 基于组件创建微信原生页
Ads Management
wechat_pages/get 获取微信原生页
Ads Management
wechat_pages/delete 删除微信原生页
Ads Management
广告应用分包 extend_package/add 创建应用分包
Ads Management
extend_package/update 更新应用子包版本
Ads Management
extend_package/get 查询应用分包列表
Ads Management
优量汇流量包 union_position_packages/add 创建联盟流量包
Ads Management
union_position_packages/update 修改联盟流量包
Ads Management
union_position_packages/get 获取联盟流量包
Ads Management
union_position_packages/delete 删除联盟流量包
Ads Management
资产授权 asset_permissions/add 资产权限授予
Ads Management
asset_permissions/delete 资产权限回收
Ads Management
asset_pre_permissions/get 获取待确认接收授权列表接口
Ads Management
asset_pre_permissions/update 确认接收授权接口
Ads Management
asset_permissions_scenes/update 更新授权权限接口
Ads Management
朋友圈头像昵称跳转页 profiles/add 创建朋友圈头像昵称跳转页
Ads Management
profiles/delete 删除朋友圈头像昵称跳转页
Ads Management
profiles/get 获取朋友圈头像昵称跳转页
Ads Management
附加创意 leads_form/add 创建表单组件
Ads Management
leads_form/get 获取表单组件详情
Ads Management
leads_form_list/get 获取表单组件列表
Ads Management
弹幕 barrage/add 添加弹幕
Ads Management
barrage/get 获取弹幕
Ads Management
barrage_recommend/get 获取推荐弹幕
Ads Management
本地门店 local_stores/add 批量录入门店
Ads Management
local_stores/update 批量编辑门店
Ads Management
local_stores/delete 批量删除门店信息
Ads Management
local_stores/get 查询门店信息
Ads Management
local_stores_address_parsing_result/get 解析门店地址
Ads Management
local_stores_search_info/get 搜索门店
Ads Management
local_stores_wxpay_merchants/get 查询微信支付商户号
Ads Management
local_stores_categories/get 查询门店类目
Ads Management
创意组件 creative_components/add 创建创意组件
Ads Management
creative_components/update 更新创意组件
Ads Management
creative_components/get 查询创意组件
Ads Management
creative_components/delete 删除创意组件
Ads Management
creative_components/update_status 更新创意组件状态
Ads Management
推广计划 campaigns/add 创建推广计划
Ads Management
campaigns/update 更新推广计划
Ads Management
campaigns/get 获取推广计划
Ads Management
Ads Insights
campaigns/delete 删除推广计划
Ads Management
广告组 adgroups/add 创建广告组
Ads Management
adgroups/update 更新广告组
Ads Management
adgroups/get 获取广告组
Ads Management
Ads Insights
adgroups/delete 删除广告组
Ads Management
广告创意 adcreatives/add 创建广告创意
Ads Management
adcreatives/update 更新广告创意
Ads Management
adcreatives/get 获取广告创意
Ads Management
Ads Insights
adcreatives/delete 删除广告创意
Ads Management
动态创意 dynamic_creatives/add 创建动态创意
Ads Management
dynamic_creatives/update 更新动态创意
Ads Management
dynamic_creatives/get 获取动态创意
Ads Management
广告 ads/add 创建广告
Ads Management
ads/update 更新广告
Ads Management
ads/get 获取广告
Ads Management
Ads Insights
ads/delete 删除广告
Ads Management
定向 targetings/add 创建定向
Ads Management
targetings/update 更新定向
Ads Management
targetings/get 获取定向
Ads Management
Ads Insights
targetings/delete 删除定向
Ads Management
targetings_share/add 定向包分享
Ads Management
targetings_share/get 获取定向包分享记录
Ads Management
关键词 bidword/add 创建关键词
Ads Management
bidword/update 替换关键词
Ads Management
bidword/delete 删除关键词
Ads Management
bidword/get 查询关键词
Ads Management
否定词 campaign_negativewords/add 新增推广计划否定词
Ads Management
adgroup_negativewords/add 新增广告组否定词
Ads Management
campaign_negativewords/update 替换推广计划否定词
Ads Management
adgroup_negativewords/update 替换广告组否定词
Ads Management
campaign_negativewords/get 查询推广计划否定词
Ads Management
adgroup_negativewords/get 查询广告组否定词
Ads Management
批量操作 batch_operation/add 批量操作(待废弃)
Ads Management
batch_requests/add 批量操作
Ads Management
advertiser/update_daily_budget 批量修改广告主日限额
Ads Management
campaigns/update_daily_budget 批量修改推广计划日限额
Ads Management
adgroups/update_daily_budget 批量修改广告组日限额
Ads Management
campaigns/update_configured_status 批量修改推广计划开启/暂停状态
Ads Management
adgroups/update_configured_status 批量修改广告组开启/暂停状态
Ads Management
ads/update_configured_status 批量修改广告开启/暂停状态
Ads Management
adgroups/update_datetime 批量修改广告组投放起止时间
Ads Management
adgroups/update_bid_amount 批量修改广告组出价
Ads Management
batch_async_requests/add 创建批量异步请求任务
Ads Management
batch_async_requests/get 获取批量异步请求任务列表
Ads Management
batch_async_request_specification/get 获取批量异步请求任务详情
Ads Management
出价 targetcpa_tag/get 获取分人群出价标签
Ads Management
文案助手 creativetools_text/get 获取广告文案
Ads Management
图片处理 image_processing/add 进行图片处理
Ads Management
广告素材预审 compliance_validation/get 获取广告素材预审结果(待废弃)
Ads Management
视频加字幕 videomaker_subtitles/add 创建视频加字幕任务
Ads Management
视频智能调整 videomaker_autoadjustments/add 创建视频智能调整任务
Ads Management
视频封面图 videomaker_videocaptures/add 生成视频封面图
Ads Management
词包 ad_param/get 获取词包
Ads Management
通配符 wildcards/get 获取落地页通配符
Ads Management
创意示例商品 creative_sample_products/get 获取创意示例商品列表
Ads Management
动态商品图片模板 dynamic_ad_image_templates/get 获取动态商品图片模板
Ads Management
动态商品视频模板 dynamic_ad_video_templates/get 获取动态商品视频模板
Ads Management
创意工具通用接口 videomaker_tasks/get 视频工具任务查询
Ads Management
自动生成创意 programmed/add 创建模板预览接口
Ads Management
programmed/update 更新模板预览接口
Ads Management
programmed/get 获取模板预览接口
Ads Management
programmed_template/get 获取模板列表接口
Ads Management
素材标签 material_labels/get 素材标签列表
Ads Management
material_labels/add 素材标签新增
Ads Management
广告数据洞察 daily_reports/get 获取日报表
Ads Insight
hourly_reports/get 获取小时报表
Ads Insight
targeting_tag_reports/get 获取定向标签报表
Ads Insights
product_catalogs_reports/get 获取商品库报表(待废弃)
Ads Insights
report/landing_page 获取落地页报表
Ads Insight
report/ad_union 获取联盟广告位报表
Ads Insight
report/video_frame 获取视频流失分析报表
Ads Insight
async_reports/add 创建异步报表任务
Ads Insight
async_reports/get 获取异步报表任务
Ads Insight
async_report_files/get 获取异步报表文件
Ads Insight
bidword_rpt/get 获取关键词报表(待废弃)
Ads Management
queryword_rpt/get 获取搜索词报表(待废弃)
Ads Management
人群数据洞察 custom_audience_insights/get 人群洞察分析
Audience Management
订单数据 ecommerce_order/get 获取订单数据
Ads Insight
ecommerce_order/update 更新订单状态
Ads Insight
线索管理平台 lead_clues/get 获取线索列表
Ads Insight
lead_clues/update 回传线索状态
Ads Insight
leads_call_virtual_number/get 获取中间号
Ads Insight
leads_call_record/get 获取通话结果
Ads Insight
leads_call_records/get 获取一个账号下的全部通话结果
Ads Insight
leads_call_token/get 获取网络电话token
Ads Insight
leads_call/create 网络电话呼叫
Ads Insight
outer_clues/add 外部线索数据导入
Ads Insight
outer_clues/update 外部线索状态更新
Ads Insight
outer_clues/action_type_report 线索上报DMP平台
Ads Insight
outer_clues_contact/update 外部线索基本信息更新
Ads Insight
leads_invalid_pay/get 获取无效赔付明细
Ads Insight
汽车视频号厂店平台 video_channel_live_data/get 视频号直播数据拉取
Ads Insight
video_channel_leads_data/get 视频号线索数据拉取接口
Ads Insight
video_channel_fans_data/get 视频号粉丝数据拉取
Ads Insight
video_channel_dealer_data/get 视频号经销商聚合数据拉取
Ads Insight
人群价值分析 custom_audience_reports/get 人群价值分析
Audience Management
客户人群 custom_audiences/add 创建客户人群
Audience Management
custom_audiences/update 更新客户人群
Audience Management
custom_audiences/get 获取客户人群
Audience Management
custom_audiences/delete 删除客户人群
Audience Management
客户人群数据文件 custom_audience_files/add 创建客户人群数据文件
Audience Management
custom_audience_files/get 获取客户人群数据文件
Audience Management
客户人群数预估 custom_audience_estimations/get 人群覆盖数预估
Audience Management
人群授权 audience_grant_relations/add 添加人群授权
Audience Management
audience_grant_relations/get 获取人群授权信息
Audience Management
标签人群 labels/get 标签广场标签获取
Audience Management
客户标签 custom_tags/add 创建客户标签
Audience Management
custom_tags/get 获取客户标签
Audience Management
custom_tags/update 更新客户标签
Audience Management
custom_tags/delete 删除客户标签
Audience Management
标签数据文件 custom_tag_files/add 上传客户标签数据文件
Audience Management
custom_tag_files/get 查询客户标签数据文件
Audience Management
用户属性数据源 user_property_sets/add 创建用户属性数据源
Audience Management
user_property_sets/update 更新用户属性数据源
Audience Management
user_property_sets/get 获取用户属性数据源
Audience Management
用户属性数据 user_properties/add 上传用户属性数据
Audience Management
用户行为数据源 user_action_sets/add 创建用户行为数据源
User Actions
user_action_sets/get 获取用户行为数据源
User Actions
user_action_set_reports/get 获取用户行为数据源报表
User Actions
data_set/add 创建数据集
User Actions
data_set/get 获取数据集
User Actions
data_source_dispatch/update 更新数据源分发关系
User Actions
data_source_dispatch/get 获取数据源分发关系
User Actions
用户行为数据 user_actions/add 上传用户行为数据
User Actions
属性数据源 property_sets/add 创建属性数据源
User Actions
property_sets/get 获取属性数据源
User Actions
属性数据源schema property_set_schemas/add 创建属性数据源schema
User Actions
property_set_schemas/update 更新属性数据源schema
User Actions
property_set_schemas/get 获取属性数据源schema
User Actions
属性数据文件上传 property_file_sessions/add 创建属性数据文件上传会话
User Actions
property_file_sessions/update 提交属性数据文件上传会话
User Actions
property_files/add 上传属性数据文件
User Actions
素材风险检测 review_element_prereview_results/get 元素预审结果查询
Ads Management
广告申诉复审 review_ad_appeal/add 发起广告申诉复审
Ads Management
review_ad_appeal/get 获取广告申诉复审结果
Ads Management
ad_appeal_quota/get 获取广告申诉复审配额
Ads Management
素材库预审 seed_element_quota/get 获取素材库预审配额
Ads Management
material_audit/submit 素材库素材提交预审
Ads Management
material_audit/list 获取素材库预审结果
Ads Management
定向标签 targeting_tags/get 获取定向标签
Ads Insight
Ads Management
targeting_tags_uv/get 获取行为/兴趣/意向标签覆盖人群数
Ads Insight
Ads Management
场景定向标签 scene_spec_tags/get 获取场景定向标签
Ads Insight
Ads Management
创意形式 adcreative_templates/get 创意形式列表信息查询(待废弃)
Ads Management
Ads Insight
adcreative_template_detail/get 创意形式详情信息查询(待废弃)
Ads Management
Ads Insight
adcreative_template/get 创意形式详情信息查询
Ads Management
Ads Insight
adcreative_template_list/get 创意形式列表信息查询
Ads Management
Ads Insight
广告投放能力 capabilities/get 查询广告相关权限(待废弃)
Ads Management
optimization_goal_permissions/get 查询优化目标权限
Ads Management
预估能力 estimation/get 人数预估
Audience Management
bid_simulation/get 出价曝光预估
Audience Management
report/conversions_predict 当日转化效果预估
Ads Insight
广告预览 adcreative_previews/add 创建广告预览
Ads Management
adcreative_previews/get 获取广告预览
Ads Management
adcreative_previews_qrcode/get 获取广告预览二维码
Ads Management
异步任务 async_tasks/add 创建异步任务
Ads Insight
async_tasks/get 获取异步任务
Ads Insight
async_task_files/get 获取异步任务文件
Ads Insight
拆分对比实验 split_tests/add 拆分对比实验创建
Ads Management
split_tests/update 拆分对比实验修改
Ads Management
split_tests/delete 拆分对比实验删除
Ads Management
split_tests/get 拆分对比实验获取
Ads Management
广告诊断 ad_diagnosis/get 广告诊断结果获取
Ads Management
广告创意预览 adcreative_template_preview/get 广告创意预览(待废弃)
Ads Management
adcreative_template_previews/get 广告创意预览
Ads Management
微信广告标签 wechat_ad_labels/get 获取微信广告标签
Ads Management
广告标签 ad_label/get 获取广告标签
Ads Management
转化归因 conversions/add 新增转化归因
Ads Management
conversions/get 获取转化归因
Ads Management
微信原生页 wechat_pages_grantinfo/get 获取原生页授权方信息
Ads Management
wechat_pages_csgrouplist/get 获取企业微信组件客服组
Ads Management
wechat_pages_csgrouplist/add 增加企业微信组件客服组
Ads Management
wechat_pages_csgrouplist/update 更新企业微信组件客服组
Ads Management
wechat_pages_csgroup_user/get 获取企业微信组件客服列表
Ads Management
wechat_pages_csgroup_status/update 更新企业微信客服状态
Ads Management
微信公众号账户升级 weixin_official_accounts_upgrade_status/get 获取微信公众号账户升级状态
Ads Management
腾讯广告账户报表指标升级 adq_reports_upgrade_status/get 获取腾讯广告账户报表指标升级状态
Ads Management
搜索推广工具 bidword_flow/get 查询关键词流量
Ads Management
keyword_recommend/get 查询关键词推荐结果(以词拓词、行业拓词)
Ads Management
business_point/get 查询行业拓词所需的业务点信息
Ads Management
视频号精选评论管理 object_comment_flag/update 设置开启、关闭精选评论
Ads Management
游戏特征信息 game_feature_tags/get 获取游戏特征标签
Ads Management
game_feature/add 新增游戏特征
Ads Management
game_feature/update 更新游戏特征
Ads Management
game_feature/get 获取游戏特征
Ads Management