资质 (Qualification)

V1.1

loading

本节将为您介绍资质 (Qualification)相关接口，平台目前同时支持腾讯广告推广帐号以及微信公众号的资质管理。更详细的介绍请参考【资质管理】章节。

微信广告行业资质和微信广告资质是用于投放朋友圈广告的资质信息，在操作微信资质前，需要先绑定微信公众号且开通微信公众号投放广告功能，有关微信资质更详细的介绍可以参考【微信开户信息】章节。

创建资质所需的系统行业id信息可参考【行业分类】，资质编码、业务范围id、以及行业/业务范围与资质编码的关系列表可参考【资质信息】。

创建广告主资质（qualifications/add）

所属权限（scope）：Account Management

更新广告主资质（qualifications/update）

所属权限（scope）：Account Management

获取广告主资质（qualifications/get）

所属权限（scope）：Account Management

删除广告主资质（qualifications/delete）

所属权限（scope）：Account Management

创建广告主资质
全部接口
V1.1
loading

所属权限	Account Management
请求地址	qualifications/add
请求方法	post

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。

参数名称	参数类型
access_token	授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节
timestamp	当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce	随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性
fields	get 接口增加 fields 字段，用于指定返回参数的字段列表，为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写，则根据默认值进行返回

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
qualification_type*	enum	资质类型，[枚举详情] 枚举列表：{ INDUSTRY_QUALIFICATION, AD_QUALIFICATION, ADDITIONAL_INDUSTRY_QUALIFICATION }
qualification_spec*	struct	资质信息
industry_spec	struct	行业资质信息，当且仅当 qualification_type=INDUSTRY_QUALIFICATION 时可填且必填
system_industry_id*	integer	行业 id，请填写二级行业 id，详见 [行业分类]
business_scope_id	integer	业务范围 id
qualification_code*	string	资质编码，详见 [资质编码列表] 字段长度最小 1 字节，长度最大 10 字节
image_id_list*	string[]	资质图片 id 列表，通过 [images 模块] 上传图片后获得数组最小长度 1，最大长度 10 字段长度最小 1 字节，长度最大 64 字节
ad_spec	struct	广告资质信息，当且仅当 qualification_type=AD_QUALIFICATION 时可填且必填
qualification_code*	string	资质编码，详见 [资质编码列表] 字段长度最小 1 字节，长度最大 10 字节
image_id_list*	string[]	资质图片 id 列表，通过 [images 模块] 上传图片后获得数组最小长度 1，最大长度 10 字段长度最小 1 字节，长度最大 64 字节
additional_industry_spec	struct	附加行业资质信息，当且仅当 qualification_type=ADDITIONAL_INDUSTRY_QUALIFICATION 时可填且必填
system_industry_id*	integer	行业 id，请填写二级行业 id，详见 [行业分类]
business_scope_id	integer	业务范围 id
qualification_code*	string	资质编码，详见 [资质编码列表] 字段长度最小 1 字节，长度最大 10 字节
image_id_list*	string[]	资质图片 id 列表，通过 [images 模块] 上传图片后获得数组最小长度 1，最大长度 10 字段长度最小 1 字节，长度最大 64 字节

使用说明

不同行业资质（INDUSTRY_QUALIFICATION）的行业 id 需一致，且需与广告主创建时填写的行业信息保持一致。
如果广告主的审核状态为审核通过，则不允许创建行业资质。
行业资质、附属行业资质、广告资质的个数限制（不包含已删除）为 10、10、500 个。

请求示例


curl 'https://api.e.qq.com/v1.1/qualifications/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'qualification_type=AD_QUALIFICATION' \
-d 'qualification_spec={
    "industry_spec": {
        "system_industry_id": 21474840687,
        "image_id_list": []
    },
    "ad_spec": {
        "image_id_list": []
    },
    "additional_industry_spec": {
        "system_industry_id": 21474840687,
        "image_id_list": []
    }
}'

应答字段

名称	类型	描述
qualification_id	integer	资质 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "qualification_id": "<QUALIFICATION_ID>"
    }
}

可视化调试工具

问题仍未解决？

请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务

更新广告主资质
全部接口
V1.1
loading

所属权限	Account Management
请求地址	qualifications/update
请求方法	post

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。

参数名称	参数类型
access_token	授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节
timestamp	当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce	随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性
fields	get 接口增加 fields 字段，用于指定返回参数的字段列表，为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写，则根据默认值进行返回

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
qualification_type*	enum	资质类型，[枚举详情] 枚举列表：{ INDUSTRY_QUALIFICATION, AD_QUALIFICATION, ADDITIONAL_INDUSTRY_QUALIFICATION }
qualification_id*	integer	资质 id
image_id_list*	string[]	资质图片 id 列表，通过 [images 模块] 上传图片后获得数组最小长度 1，最大长度 10 字段长度最小 1 字节，长度最大 64 字节

使用说明

当且仅当资质 id 的审核状态非审核通过时，才可进行更新。
指定某一 qualification_id，全量更新该资质 id 下的所有资质图片。

请求示例


curl 'https://api.e.qq.com/v1.1/qualifications/update?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'qualification_type=AD_QUALIFICATION' \
-d 'qualification_id=<QUALIFICATION_ID>' \
-d 'image_id_list=[]'

应答字段

名称	类型	描述
qualification_id	integer	资质 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "qualification_id": "<QUALIFICATION_ID>"
    }
}

可视化调试工具

问题仍未解决？

请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务

获取广告主资质
全部接口
V1.1
loading

所属权限	Account Management
请求地址	qualifications/get
请求方法	get

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。

参数名称	参数类型
access_token	授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节
timestamp	当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce	随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性
fields	get 接口增加 fields 字段，用于指定返回参数的字段列表，为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写，则根据默认值进行返回

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
qualification_type*	enum	资质类型，[枚举详情] 枚举列表：{ INDUSTRY_QUALIFICATION, AD_QUALIFICATION, ADDITIONAL_INDUSTRY_QUALIFICATION }
filtering	struct[]	过滤条件，若此字段不传，或传空则视为无限制条件，详见 [过滤条件] 数组长度为 1
field*	string	过滤字段可选值：{ qualification_id }
operator*	enum	操作符当 field 取值 qualification_id 时，枚举列表：{ EQUALS, IN }
values*	string[]	字段取值，values 数组的个数限制与 operator 的取值相关，详见 [过滤条件]

请求示例


curl -G 'https://api.e.qq.com/v1.1/qualifications/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'qualification_type=AD_QUALIFICATION' \
-d 'filtering=[]'

应答字段

名称	类型	描述
industry_qualifications	struct[]	行业资质信息
qualification_id	integer	资质 id
system_industry_id	integer	行业 id，请填写二级行业 id，详见 [行业分类]
business_scope_id	integer	业务范围 id
qualification_code	string	资质编码，详见 [资质编码列表]
image_id_list	string[]	资质图片 id 列表，通过 [images 模块] 上传图片后获得
qualification_status	enum	资质状态，[枚举详情]
expired_date	string	资质有效日期，日期格式：YYYY-MM-DD，空代表永久有效
reject_message	string	审核消息
created_time	integer	创建时间（时间戳）
last_modified_time	integer	最后修改时间（时间戳）
ad_qualifications	struct[]	广告资质信息
qualification_id	integer	资质 id
qualification_code	string	资质编码，详见 [资质编码列表]
image_id_list	string[]	资质图片 id 列表，通过 [images 模块] 上传图片后获得
qualification_status	enum	资质状态，[枚举详情]
expired_date	string	资质有效日期，日期格式：YYYY-MM-DD，空代表永久有效
is_mdm_shared	enum	资质共享状态，[枚举详情]
reject_message	string	审核消息
created_time	integer	创建时间（时间戳）
last_modified_time	integer	最后修改时间（时间戳）
additional_industry_qualifications	struct[]	附加行业资质信息
qualification_id	integer	资质 id
system_industry_id	integer	行业 id，请填写二级行业 id，详见 [行业分类]
business_scope_id	integer	业务范围 id
qualification_code	string	资质编码，详见 [资质编码列表]
image_id_list	string[]	资质图片 id 列表，通过 [images 模块] 上传图片后获得
qualification_status	enum	资质状态，[枚举详情]
expired_date	string	资质有效日期，日期格式：YYYY-MM-DD，空代表永久有效
reject_message	string	审核消息
created_time	integer	创建时间（时间戳）
last_modified_time	integer	最后修改时间（时间戳）

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "industry_qualifications": [
            {
                "qualification_id": "<QUALIFICATION_ID>",
                "system_industry_id": 21474840687,
                "image_id_list": [],
                "reject_message": "Reject message example",
                "created_time": 1491019858,
                "last_modified_time": 1491098468
            }
        ],
        "ad_qualifications": [
            {
                "qualification_id": "<QUALIFICATION_ID>",
                "image_id_list": [],
                "reject_message": "Reject message example",
                "created_time": 1491019858,
                "last_modified_time": 1491098468
            }
        ],
        "additional_industry_qualifications": [
            {
                "qualification_id": "<QUALIFICATION_ID>",
                "system_industry_id": 21474840687,
                "image_id_list": [],
                "reject_message": "Reject message example",
                "created_time": 1491019858,
                "last_modified_time": 1491098468
            }
        ]
    }
}

可视化调试工具

问题仍未解决？

请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务

删除广告主资质
全部接口
V1.1
loading

所属权限	Account Management
请求地址	qualifications/delete
请求方法	post

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。

参数名称	参数类型
access_token	授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节
timestamp	当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce	随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性
fields	get 接口增加 fields 字段，用于指定返回参数的字段列表，为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写，则根据默认值进行返回

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
qualification_type*	enum	资质类型，[枚举详情] 枚举列表：{ INDUSTRY_QUALIFICATION, AD_QUALIFICATION, ADDITIONAL_INDUSTRY_QUALIFICATION }
qualification_id	integer	资质 id。当资质类型为 AD_QUALIFICATION 时，为非必填项，可以使用 qualification_id_list 批量删除；当资质类型非 AD_QUALIFICATION，该字段为必填项
qualification_id_list	integer[]	资质 id 列表数组最小长度 0，最大长度 20

使用说明

当资质类型为 ADDITIONAL_INDUSTRY_QUALIFICATION 时，仅可删除非"审核通过(QUALIFICATION_STATUS_NORMAL)"状态的资质，当资质类型为 INDUSTRY_QUALIFICATION、AD_QUALIFICATION 时删除不受限制。
当资质类型为 AD_QUALIFICATION 时，支持批量删除资质，qualification_id 和 qualification_id_list 二选一即可。如果同时传 qualification_id 和 qualification_id_list，优先使用 qualification_id_list 批量删除资质。
当资质类型为非 AD_QUALIFICATION 时，不支持批量删除，qualification_id 为必填字段。

请求示例


curl 'https://api.e.qq.com/v1.1/qualifications/delete?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'qualification_type=AD_QUALIFICATION' \
-d 'qualification_id=<QUALIFICATION_ID>' \
-d 'qualification_id_list=[]'

应答字段

名称	类型	描述
qualification_id	integer	资质 id
qualification_id_list	integer[]	资质 id 列表

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "qualification_id": "<QUALIFICATION_ID>",
        "qualification_id_list": []
    }
}

可视化调试工具

问题仍未解决？

请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务

首页

开发文档

最新动态

腾讯广告

资质 (Qualification)

V1.1

loading

创建广告主资质
全部接口
V1.1
loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

更新广告主资质
全部接口
V1.1
loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

获取广告主资质
全部接口
V1.1
loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

删除广告主资质
全部接口
V1.1
loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

首页

开发文档

最新动态

腾讯广告

资质 (Qualification) V1.1 loading

创建广告主资质 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

更新广告主资质 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

获取广告主资质 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

删除广告主资质 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

资质 (Qualification)

V1.1

loading

创建广告主资质
全部接口
V1.1
loading

更新广告主资质
全部接口
V1.1
loading

获取广告主资质
全部接口
V1.1
loading

删除广告主资质
全部接口
V1.1
loading