腾讯开发者平台注册教程：如何使用Marketing API进行接口调用与权限申请？

<苏州股票配资>腾讯开发者平台注册教程：如何使用Marketing API进行接口调用与权限申请？

当您决定开始使用 API进行接口调用，您需要首先注册成为开发者：

Step 1：进入注册页面。点击开发者官网右上角注册按钮即可进入；

Step 2：关联QQ号作为开发者登录凭证。进入注册页面后，如果当前电脑已经登录QQ客户端，则默认显示以当前登录QQ号作为快捷登录，您也可以点击“帐号密码登录”换用其他QQ号；

Tips:

关联QQ号是开发者登录的唯一凭证，且不能进行修改。对于企业开发者，建议使用公用QQ帐号进行注册，并妥善保管。

如果您已经是腾讯广告的客户（代理商或广告主），建议您直接用代理商帐号或广告主帐号的开户QQ进行注册。

Step 3：完善开发者资料。将资料填写完整并通过手机验证码验证通过后，即完成开发者注册。

2. 如何创建应用程序并申请权限？2.1 开发者应用的分类及作用

通过腾讯广告开发者专区创建的应用程序是指基于 API开发的应用，比如管理广告的投放平台、广告数据分析工具、自动化营销的脚本等。创建应用程序的目的是为了获取所需接口在正式环境的调用权限。在获取正式环境的接口权限前，建议您先通过沙箱环境进行接口调试。

开发者应用按注册者类型和权限范围，可以分为私有应用及第三方应用两类（每一类应用最多可申请20个）。下面将介绍这两类应用的适用场景及具体差异。

私有应用

当您的开发者注册QQ同时是代理商、广告主、商务管家等身份的开户QQ时，您可创建私有应用，通过该应用，您可以直接操作注册QQ对应的账号名下的广告身份（如代理商可操作代理商本人及其子客信息，商务管家账号可以操作商务管家账号下认领的广告账号信息）。

Tips:

第三方应用

当您希望通过 API管理多广告账号、或为广告行业提供第三方技术服务时，您可以通过创建第三方应用来实现。

Tips:

2.2 应用的申请及创建

Step1: 注册成为开发者后，在开发者官网进行登陆并进入应用程序管理看板，可选择创建私有应用或第三方应用（私有应用的前置条件是您的开发者注册QQ账号同时为代理商、广告主、商务管家等身份的开户QQ），则界面会显示相应的创建入口如下图：

Step 2：点击“创建新应用”进入创建应用程序界面，填写应用名称、应用介绍信息等。请注意，私有应用需要填写的内容比第三方应用少，但仅可管理该QQ号对应的广告账号。

应用名称：应用程序的名称，多个应用程序不允许重名。应用介绍：介绍您的应用程序希望基于 API实现的功能及您需要功能通过审核的原因。回调地址将用于OAuth 2.0授权完成后的跳转及信息返回到您指定地址，供您获取相关返回信息,详情可参考发起请求。 Token有效期：该应用下 token的有效时长，默认为24小时 Token有效期：该应用下 token的有效时长，默认为30天， token有效期需大于 token。注： token 和 token详细介绍见。

Step 3：您可根据使用需要选择对应的权限组分类，权限组分类的详细介绍可通过权限等级进一步了解 – 创建后，私有应用自动审核通过，您可以立即开始相关能力的搭建。第三方应用则会在2-3个工作日内进行审核。

3. 发起请求，开启智能化营销体验3.1 授权认证{ #auth }

Token是在 API操作指定账号的身份凭证，当您需要操作特定广告账号时，您需要使用该广告账号对您的开发者应用进行授权，以获取和，所有接口均通过请求参数中传递的 （授权令牌）来进行身份认证和鉴权，系统会在校验 有效、接口调用配额未用完、接口调用频次未超限3个条件符合后接受此次请求进行具体业务处理并做出响应。

API目前支持代理商/商务管家/广告主等账号类型进行授权鉴权。

本节将为您介绍如何进行 API 的授权认证 。

该环节您可以获取指定账号的和，其中：

3.1.1 私有应用如何获取和

进入应用详情界面

首先选择您要操作的账户身份：如广告主、服务商、商务管家、T1等（因同一个QQ可以同时具有多个身份，不同的身份的token是不同的）。

点击“获取或重置”即可获取或者重置您的token

3.1.2 第三方应用如何通过 OAuth 2.0 获得

客户需要通过您的应用进行推广操作时，您的应用需要先引导客户完成至少一次 OAuth 2.0 认证操作，以便获得调用接口操作的客户的推广帐号所必须的 。 API的 OAuth 2.0 遵循业界通用的规范和流程，完成 OAuth 2.0 认证（当前只支持 -side 模式）需要完成以下步骤：

详细描述如下：

Step 1：引导客户完成OAuth 2.0认证获得，获得 需要引导客户完成 OAuth 2.0 的认证。调用 OAuth 2.0 授权页面的URL形如：。其中：

账户分类支持角色可管理的账户范围

商务管家账号

超级管理员（开户qq/微信）

该商务管家及其认领的所有账户

代理商主体账号

代理商超级管理员（开户qq/微信）

当前代理商主体下所有代理商和所有代理子客户

代理商帐号

代理商超级管理员（开户qq/微信）

当前代理商及所有代理子客户

代理商帐号

代理商管理员/子账号管理员/运营人员

该员工有权管理的所有代理商子客

代理商帐号

广告主员工（自理投放管理员）

该员工有权管理的所有代理商子客

直客广告主账号

超级管理员（开户qq/微信）

该广告主账户

Step 2：使用 获得 和 。用 获得 和 的接口地址为 ，接口输入参数如下表所示：

请求参数：

字段名类型描述

应用 id，在开发者官网创建应用后获得，可通过 应用程序管理页面 查看

应用 ，在开发者官网创建应用后获得，可通过 应用程序管理页面 查看

字段长度最小 1 字节，长度最大 256 字节

请求的类型，可选值： （授权码方式获取 token ）、 (刷新 token )

字段长度最小 1 字节，长度最大 64 字节

OAuth 认证 code，可通过获取 Code 接口获取，当 = 时必填

字段长度最小 1 字节，长度最大 64 字节

应用 token，当 = 时必填

字段长度最小 1 字节，长度最大 256 字节

应用回调地址，当 = 时， 为必传参数，仅支持 http 和 https，不支持指定端口号，且传入的地址需要与获取 时，传入的回调地址保持一致

字段长度最小 1 字节，长度最大 1024 字节

请求示例：

curl -G 'https://api.e.qq.com/oauth/token' \
    -d 'client_id=' \
    -d 'client_secret=' \
    -d 'grant_type=authorization_code' \ 
    -d 'authorization_code=' \
    -d 'redirect_uri=https://www.example.com'

返回示例：

{
    code: 0,
    message: ,
    data: {
        access_token: 228bd56b7ee039540953352f766b40d31651487e,
        refresh_token: 854e744a1f4c6fc20f498e366b9aabd2c4b971fd,
        access_token_expires_in: 86400,
        refresh_token_expires_in: 2592000 
    }
}

获得 后，您可用此调用接口对相关的推广帐号进行操作，如果发起 API请求可通过发起请求章节进行了解。

值得注意的是，一旦 失效，您将无法调用接口。 和 的有效期可以通过 oauth/token 接口的返回字段获取，默认情况下 和 的有效期如下：

3.1.3 如何刷新

在有效期内，您可以用 通过 auth/token 接口刷新 。请求示意如下：

curl -G 'https://api.e.qq.com/oauth/token' \
    -d 'client_id=' \
    -d 'client_secret=' \
    -d 'grant_type=refresh_token' \
    -d 'refresh_token='

特别注意，每次刷新时， 会自动续期。

3.1.4 如何刷新

如果 失效，您需要重新通过 OAuth 2.0 获得新的 和 。

关于 OAuth 2.0 相关接口说明，可以参考接口清单中的 OAuth 相关接口。

4. 常见问题开发者官网的应用程序与推广的应用程序有什么关系？

开发者官网的应用程序是指基于 API开发的应用，比如管理广告的投放平台、广告数据分析工具、自动化营销的脚本等等，而推广的应用程序是指广告主推广的目标应用。两者之前并无任何关联。

我需要为多个应用上报行为数据，需要分别创建应用程序么？

不需要。您只需创建一个应用程序，并申请数据上报的权限即可。一个应用可以获得多个推广帐号的授权，从而帮多个推广帐号上报数据。

应用程序审核通过后，是否就可以操作推广帐号了？

应用程序的审核是指给应用程序分配相应的接口权限，但是应用程序能操作哪些推广帐号，需要通过OAuth 2.0向指定的推广帐号发起授权申请，当指定的推广帐号同意授权后，应用程序即可调用接口对该帐号进行操作。