术语介绍和技术准备
本节将为您介绍 Marketing API 中涉及的概念术语和技术能力，有助于您快速地理解和使用API。如果您是初次接触腾讯Marketing API，建议您在开始进行具体接口调试之前对本章节内容进行了解。 接下来，我们将对以下几块内容进行重点介绍：
术语介绍{ #step1 }
了解这些术语及其概念有助于您更好的了解接下来章节中介绍的内容，以及您可能即将调用的相关接口的字段含义。
| 术语 | 中文名 | 详细描述 |
|---|---|---|
| agency | 代理商 | 为广告主投放并管理广告的代理机构。 通过代理商创建帐号的广告主称之为子客，未通过代理商创建帐号的广告主称之为直客。 |
| account | 客户帐号 | 通过腾讯广告平台开展推广业务的客户，包括代理商、直客、子客三种类型。每个客户在腾讯广告平台上可能有一个或多个帐号，每个帐号对应唯一的 account_id。 仅广告主帐号（直客以及子客）才能投放广告。 |
| developer | 开发者 | 特指基于 TSA Marketing API 进行相关功能开发的企业； 开发者可以是客户（代理商、直客、子客）本人，也可以是第三方的技术公司； 所有开发者需要通过腾讯广告开发者官网进行注册才能拥有 Marketing API 的使用权限。立刻注册 |
| client_id | 应用程序id | 开发者官网为在官网中创建并审核通过的应用程序分配的id，每个应用程序对应唯一的 client_id ； 应用程序可以是网站、PC应用、手机应用，如广告客户自有的内部系统、广告代理商的 Trading Desk 系统等等； Marketing API 的接口权限、资源授权等均基于应用程序进行控制。 |
| client_secret | 应用程序密钥 | 每个应用程序对应的密钥，在开发者创建的应用程序被审批通过时由系统分配； 用于在 Marketing API 的鉴权认证过程中获得调用API的 access_token； 每个应用程序对应唯一的 client_secret。 |
| access_token | 授权令牌 | Marketing API 每次接口调用中用于鉴别权限的参数，包含客户授予当前应用程序访问其帐号的信息； 通常需要应用程序引导客户通过完成 OAuth 2.0 授权后才能获得。 |
| campaign | 推广计划 | 一系列相似或相关推广内容的集合。例如，您可以将推广某一款产品的所有广告放在一个推广计划中，也可以将某一期推广活动相关的广告都放在一个推广计划中。 |
| adgroup | 广告组 | 共享相同的推广时间、受众目标、投放广告版位、出价等信息的多个广告的集合。 |
| ad | 广告 | 广告主可以管理的最小的展示单元； 每个广告必须属于一个广告组，必须且只能引用一个创意。 |
| adcreative | 广告创意 | 呈现给受众的元素集合，可能是文字、图片、视频等一种或多种元素的组合； |
| adcreative_template | 创意形式 | 对创意中元素的具体描述和限定。一般情况下，不同创意形式具有的元素或其属性（如图片的尺寸、字符限制等）不同； 每个创意形式对应唯一的 adcreative_template_id，例如 adcreative_template_id=2 时，限制创意中必须包含一个长度小于 18 的文本和一张尺寸为 160*210 的图片两个元素； 一个广告创意只能对应一个创意形式。 |
| promoted_object | 推广目标 | 待推广的具体目标，比如某个网页 http://www.qq.com 、微信 Android 版等。 |
| promoted_object_type | 推广目标类型 | 待推广标的物的类型，例如普通链接、腾讯开放平台移动应用、苹果应用、微信品牌活动页等。 |
| targeting | 定向 | 用于筛选广告受众的条件组合； 可以根据多个维度筛选出合适的受众并应用在广告投放环节。 |
| DMP | 腾讯广告数据管理平台 | 特指腾讯广告数据管理平台（Data Management Platform）； 通过开放丰富的数据能力，为合作方提供智能化的人群画像分析，打破数据孤岛，分享数据红利，提升行业整体价值。详见 dmp.qq.com。 |
| DPA | 动态商品广告 | 特指动态商品广告（Dynamic Product Ads） |
技术准备{ #step2 }
Marketing API 文档所涉及接口均遵循HTTPS协议，您可以使用任何支持HTTPS协议和JSON格式的编程语言开发应用程序。
- 有关标准HTTPS协议，可参考 RFC818 或 维基百科-HTTPS 相关介绍。
- 有关JSON数据格式，可参考 JSON.ORG 或 维基百科–JSON 相关介绍。
Marketing API 文档中的请求示例均为通过cURL方式发起请求的示例，cURL的用法可参考 维基百科-cURL相关介绍。同时我们提供了可视化的调试工具（登录后可在每篇文档页面中使用），以便提高您调试和编码的效率。另外，接口文档中所描述的integer类型代表整型，并不一定代表开发语言的int类型。对于某些字段可能存在长度问题，详情可参考 广告相关ID取值升级通知。
