通过 Authorization Code 获取 Access Token 或刷新 Access Token
全部接口
V1.1
loading
V1.1
loading
| 所属权限 | Account Management,Ads Management,Ads Insights,Audience Management,User Actions |
| 请求地址 | https://api.e.qq.com/oauth/token |
| 请求方法 | get |
请求参数
标有*的参数为必填项
| 名称 | 类型 | 描述 |
|---|---|---|
|
client_id*
|
integer | 应用 id，在开发者官网创建应用后获得，可通过 [应用程序管理页面] 查看 |
|
client_secret*
|
string | 应用 secret，在开发者官网创建应用后获得，可通过 [应用程序管理页面] 查看 字段长度最小 1 字节，长度最大 256 字节 |
|
grant_type*
|
string | 请求的类型，可选值：authorization_code（授权码方式获取 token）、refresh_token（刷新 token） 字段长度最小 1 字节，长度最大 64 字节 |
|
authorization_code
|
string | OAuth 认证 code，可通过获取 Authorization Code 接口获取，当 grant_type=authorization_code 时必填 字段长度最小 1 字节，长度最大 64 字节 |
|
refresh_token
|
string | 应用 refresh token，当 grant_type=refresh_token 时必填 字段长度最小 1 字节，长度最大 256 字节 |
|
redirect_uri
|
string | 应用回调地址，当 grant_type=authorization_code 时，redirect_uri 为必传参数，仅支持 http 和 https，不支持指定端口号，且传入的地址需要与获取 authorization_code 时，传入的回调地址保持一致 字段长度最小 1 字节，长度最大 1024 字节 |
使用说明
- OAuth 相关接口无需提供 access_token、timestamp、nonce 等通用请求参数。
请求示例
curl -G 'https://api.e.qq.com/oauth/token' \
-d 'client_id=<CLIENT_ID>' \
-d 'client_secret=<CLIENT_SECRET>' \
-d 'grant_type=refresh_token' \
-d 'refresh_token=<REFRESH_TOKEN>'
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
|
authorizer_info
|
struct | 权限信息，当 grant_type=refresh_token 时不返回 |
|
account_uin
|
integer | 授权的推广帐号对应的 QQ 号 |
|
account_id
|
integer | 授权的推广帐号 id，大部分接口均需同步该字段，请妥善保存 |
|
scope_list
|
string[] | 权限列表，若为空，则表示拥有所属应用的所有权限 |
|
wechat_account_id
|
string | 授权的推广帐号对应的微信帐号 id |
|
account_role_type
|
enum | 授权账号身份类型，授权账号类型广告主,代理商,T1 账户,商务管家账户，[枚举详情] |
|
account_type
|
enum | 账号类型，[枚举详情] |
|
role_type
|
enum | 角色，[枚举详情] |
|
access_token
|
string | 应用 access token |
|
refresh_token
|
string | 应用 refresh token，当 grant_type=refresh_token 时不返回 |
|
access_token_expires_in
|
integer | access_token 过期时间，单位（秒） |
|
refresh_token_expires_in
|
integer | refresh_token 过期时间，单位（秒），当 grant_type=refresh_token 时不返回 |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"authorizer_info": {
"account_uin": 2644750491,
"account_id": 2947221,
"scope_list": [
"ads_management",
"ads_insights",
"account_management",
"audience_management",
"user_actions"
],
"wechat_account_id": "spid1234567890",
"account_role_type": "ACCOUNT_ROLE_TYPE_AGENCY"
},
"access_token": "<ACCESS_TOKEN>",
"access_token_expires_in": 86400,
"refresh_token_expires_in": 2592000
}
}问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
