腾讯广告开发文档

2023年06月09日 21:37 402
快速入门本节将为您介绍如何成为Marketing API开发者,开启您的智能化营销体验生活。在调用Marketing API接口前,您必须先注册成为开发者并创建应用申请对应的接口权限

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

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

fund_statements_daily/get 获取资金账户日结明细

Account Management

daily_balance_report/get 获取资金账户日结明细(新)

Account Management

fund_statements_detailed/get 获取资金账户流水

Account Management

wechat_funds/get 获取微信广告账号资金账户信息

Account Management

wechat_fund_statements_detailed/get 获取微信广告账号资金账户流水

Account Management

realtime_cost/get 获取腾讯广告平台账号体系的实时消耗余额

Ads Management

agency_realtime_cost/get 获取服务商实时消耗

Account Management

agency_inner_transfer/add 服务商内部转账

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

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

视频 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

products_system_status/get 获取审核失败的商品

Ads Management

product_categories_list/get 获取商品类目

Ads Management

product_series/get 获取商品系列

Ads Management

动态商品模板 dynamic_ad_templates/get 获取动态商品广告模板

Ads Management

动态商品图片 dynamic_ad_images/add 根据DPA模板生成图片

Ads Management

dynamic_ad_images/get 获取DPA模板生成的图片

Ads Management

动态商品视频 dynamic_ad_video/add 根据DPA模板生成视频

Ads Management

微信原生页 wechat_pages/add 基于模板创建微信原生页

Ads Management

wechat_pages_custom/add 基于组件创建微信原生页

Ads Management

wechat_pages/get 获取微信原生页

Ads Management

wechat_pages/delete 删除微信原生页

Ads Management

应用宝渠道包 android_channel_packages/get 获取安卓渠道包

Ads Management

广告渠道包 android_union_channel_packages/get 获取广告渠道包

Ads Management

android_union_channel_packages/add 通过url创建广告渠道包

Ads Management

android_union_channel_packages/update 更新url广告渠道包

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

朋友圈头像昵称跳转页 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

推广计划 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

批量操作 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

文案助手 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

动态商品图片模板 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

广告数据洞察 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

人群数据洞察 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

outer_clues/add 外部线索数据导入

Ads Insight

outer_clues/update 外部线索状态更新

Ads Insight

outer_clues_contact/update 外部线索基本信息更新

Ads Insight

leads_invalid_pay/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

用户行为数据 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

附近推开户 wechat_advertiser_local_business/add 添加商家

Account Management

wechat_advertiser_local_business/update 更新商家

Account Management

wechat_advertiser_local_business/get 查询商家

Account Management

附近推账户资金 wechat_fund_transfer/add 微信服务商与子客之间转账

Account Management

附近推账户资质 wechat_qualifications/add 添加资质

Account Management

wechat_qualifications/delete 删除资质

Account Management

wechat_qualifications/get 获取资质

Account Management

附近推广告投放 local/add 创建广告

Ads Management

local/get 获取广告

Ads Management

local/update 更新广告

Ads Management

local_endadsmanually/add 手动结束广告

Ads Management

local_estimatedamount/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

素材风险检测 review_element_prereview_results/get 元素预审结果查询

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

广告诊断 diagnosis/get 广告诊断结果获取(待废弃)

Ads Management

ad_diagnosis/get 广告诊断结果获取

Ads Management

广告状态获取 system_status/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

标签相关
分类相关