广告帐号 (Advertiser)

V1.1

loading

本节将为您介绍广告帐号 (Advertiser)相关接口。通过广告帐号相关接口您可以查看并维护自己的帐号资料。如果您是代理商，还可以进行开户操作。特别注意，广告主资质相关接口仅用于上传开通微信公众号广告功能所需的资质信息。更详细的介绍可以参考【帐号资料】章节。

添加服务商子客（advertiser/add）

所属权限（scope）：Account Management

更新广告主信息（advertiser/update）

所属权限（scope）：Account Management

获取广告主信息（advertiser/get）

所属权限（scope）：Account Management, Ads Management, Ads Insights, Audience Management, User Actions

获取商务管家账号下广告主信息（business_manager_relations/get)

所属权限（scope）：Account Management, Ads Management, Ads Insights, Audience Management, User Actions

添加腾讯广告服务商子客
全部接口
V1.1
loading

所属权限	Account Management
请求地址	advertiser/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 中的字段。如不填写，则根据默认值进行返回

特定请求头参数

该接口支持一些特定请求头的参数，该参数支持放入请求的请求头中，注意不是请求体中。

请求头名称	描述
X-Request-Id	资源请求的唯一 id，该请求头参数用于保证接口重试的幂等性，即当请求参数是 A 时，X-Request-Id 为 B 时，即使重复请求，API 侧永远不会新建一个全新的广告资源，避免重试的时候重复创建。如果在创建时重复传入相同的请求参数和 X-Request-Id，那么会返回该 X-Request-Id 对应的唯一的广告资源。支持的接口列表参考投放接口错误处理指引章节

请求头名称

描述

X-Request-Id

资源请求的唯一 id，该请求头参数用于保证接口重试的幂等性，即当请求参数是 A 时，X-Request-Id 为 B 时，即使重复请求，API 侧永远不会新建一个全新的广告资源，避免重试的时候重复创建。如果在创建时重复传入相同的请求参数和 X-Request-Id，那么会返回该 X-Request-Id 对应的唯一的广告资源。支持的接口列表参考投放接口错误处理指引章节

请求参数

标有*的参数为必填项

名称	类型	描述
corporation_name*	string	企业名称字段长度最小 1 字节，长度最大 120 字节
corporation_licence	string	必填，企业营业执照注册号字段长度最小 1 字节，长度最大 18 字节
certification_image_id*	string	营业执照/企业资质证明图片 id，通过 [images 模块] 上传图片后获得字段长度最小 1 字节，长度最大 64 字节
individual_qualification	struct	个人身份证明，如果帐号类型是企业，则此字段必填，且需上传法人身份证照片；如果帐号类型是个人，则上传个人身份证照片
identification_front_image_id*	string	身份证图片（正面）id，通过 [images 模块] 上传图片后获得字段长度最小 1 字节，长度最大 64 字节
identification_back_image_id*	string	身份证图片（反面）id，通过 [images 模块] 上传图片后获得字段长度最小 1 字节，长度最大 64 字节
system_industry_id*	integer	开户行业 id，请填写二级行业 id，详见 [行业分类]
area_code	integer	公司所在地，需与营业执照注册地域一致，具体值参照附录中的 [地域信息]
corporate_image_name	string	企业形象名称字段长度最小 1 字节，长度最大 120 字节
introduction_url*	string	业务介绍页地址，可填写公司网站、APP 下载页、H5 链接等，作为开户信息参考字段长度最小 1 字节，长度最大 255 字节
corporate_brand_name	string	品牌名称字段长度最小 0 字节，长度最大 256 字节
contact_person_telephone	string	联系人座机电话号码，格式为：区号-座机号，例如：0755-8601338 字段长度最小 0 字节，长度最大 20 字节
contact_person_mobile	string	联系人手机号码，例如：+8613900000000 或 13900000000 字段长度最小 0 字节，长度最大 20 字节

请求示例


curl 'https://api.e.qq.com/v1.1/advertiser/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'corporation_name=腾讯计算机系统有限公司' \
-d 'corporation_licence=888888888888888888' \
-d 'certification_image_id=<IMAGE_ID>' \
-d 'individual_qualification={
    "identification_front_image_id": "<IMAGE_ID>",
    "identification_back_image_id": "<IMAGE_ID>"
}' \
-d 'system_industry_id=21474840687' \
-d 'area_code=110100' \
-d 'corporate_image_name=腾讯' \
-d 'introduction_url=https://www.tencent.com' \
-d 'contact_person_telephone=0755-86013388' \
-d 'contact_person_mobile=13900000000'

应答字段

名称	类型	描述
account_id	integer	广告主帐号 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "account_id": "<ACCOUNT_ID>"
    }
}

可视化调试工具

问题仍未解决？

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

更新腾讯广告广告主信息
全部接口
V1.1
loading

所属权限	Account Management
请求地址	advertiser/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
daily_budget	integer	竞价广告账户日预算，单位为分，设置为 0 表示不设预算（即不限）；仅对竞价广告生效，合约广告不受影响，日预算要求介于 5,000 分– 4,000,000,000 分之间（50 元-40,000,000 元，单位为人民币）当广告帐号下有微信朋友圈广告：下调日预算不能低于今日已消耗金额的 1.2 倍每次修改幅度不能低于 5,000 分（50 元，单位为人民币）当广告帐号下为非微信朋友圈广告：修改后的日预算不能低于今日已消耗金额的 1.05 倍（当今日已消耗金额的 5% 大于 50 元时），或不能低于今日已消耗金额加上 5000 分（50 元，单位为人民币，当今日已消耗金额的 5% 小于等于 50 元时）每次修改幅度不能低于 5,000 分（50 元，单位为人民币）
system_industry_id	integer	行业 id，请填写二级开户行业 id，详见 [行业分类]
corporation_name	string	企业名称字段长度最小 1 字节，长度最大 120 字节
corporation_licence	string	企业营业执照注册号字段长度最小 1 字节，长度最大 18 字节
certification_image_id	string	营业执照/企业资质证明图片 id，通过 [images 模块]上传图片后获得字段长度最小 1 字节，长度最大 64 字节
individual_qualification	struct	个人身份证明，如果帐号类型是企业，则此字段必填，且需上传法人身份证照片；如果帐号类型是个人，则上传个人身份证照片
identification_front_image_id*	string	身份证图片（正面）id，通过 [images 模块] 上传图片后获得字段长度最小 1 字节，长度最大 64 字节
identification_back_image_id*	string	身份证图片（反面）id，通过 [images 模块] 上传图片后获得字段长度最小 1 字节，长度最大 64 字节
area_code	integer	公司所在地，需与营业执照注册地域一致，具体值参照附录中的 [地域信息]
corporate_image_name	string	企业形象名称字段长度最小 1 字节，长度最大 120 字节
introduction_url	string	业务介绍页地址，可填写公司网站、APP 下载页、H5 链接等，作为开户信息参考字段长度最小 1 字节，长度最大 255 字节
corporate_brand_name	string	品牌名称字段长度最小 0 字节，长度最大 256 字节
contact_person_telephone	string	联系人座机电话号码，格式为：区号-座机号，例如：0755-8601338 字段长度最小 0 字节，长度最大 20 字节
contact_person_mobile	string	联系人手机号码，例如：+8613900000000 或 13900000000 字段长度最小 0 字节，长度最大 20 字节
websites	struct[]	推广链接列表数组最小长度 0，最大长度 255
website_domain*	string	推广链接域名，无需 http 前缀，如 www.qq.com 字段长度最小 1 字节，长度最大 1024 字节
icp_image_id*	string	网站 icp 备案证书扫描图片，通过 [images 模块] 上传图片后获得字段长度最小 1 字节，长度最大 64 字节

使用说明

修改成功后（contact_person_telephone、contact_person_mobile、daily_budget、websites 的修改除外），帐号信息将被重新审核，审核最长需一个工作日，在审核通过前，该帐号的所有广告都将无曝光，审核通过后恢复正常。
已审核通过的广告帐号禁止修改公司名称（corporation_name）、营业执照号（corporation_licence）、营业执照照片（certification_image_id）、法人身份证（individual_qualification）、地域（area_code）字段。
如需修改行业，请先删除原行业所对应的行业资质。

请求示例


curl 'https://api.e.qq.com/v1.1/advertiser/update?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'daily_budget=2000' \
-d 'system_industry_id=21474840687' \
-d 'corporation_name=腾讯计算机系统有限公司' \
-d 'corporation_licence=888888888888888888' \
-d 'certification_image_id=<IMAGE_ID>' \
-d 'individual_qualification={
    "identification_front_image_id": "<IMAGE_ID>",
    "identification_back_image_id": "<IMAGE_ID>"
}' \
-d 'area_code=110100' \
-d 'corporate_image_name=腾讯' \
-d 'introduction_url=https://www.tencent.com' \
-d 'contact_person_telephone=0755-86013388' \
-d 'contact_person_mobile=13900000000' \
-d 'websites=[{"website_domain":"www.tencent.com","icp_image_id":"<IMAGE_ID>"}]'

应答字段

名称	类型	描述
account_id	integer	广告主帐号 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "account_id": "<ACCOUNT_ID>"
    }
}

可视化调试工具

问题仍未解决？

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

查询腾讯广告广告主信息
全部接口
V1.1
loading

所属权限	Account Management,Ads Management,Ads Insights,Audience Management,User Actions
请求地址	advertiser/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 中的字段。如不填写，则根据默认值进行返回

请求参数

标有*的参数为必填项

名称	类型	描述
agency_id	integer	服务商账号 id，服务商主体请求时必填、其他 token 忽略此参数最小值 1
account_id	integer	广告主帐号 id，直客客户必须填写，代理商可不填写; 如代理商不填写，则获取代理商下全部子客户的信息最小值 1
filtering	struct[]	过滤条件，若此字段不传，或传空则视为无限制条件，详见 [过滤条件] 数组长度为 1
field*	string	过滤字段可选值：{ corporation_name }
operator*	enum	操作符当 field 取值 corporation_name 时，枚举列表：{ EQUALS, CONTAINS }
values*	string[]	字段取值，values 数组的个数限制与 operator 的取值相关，详见 [过滤条件] 当 field 取值 corporation_name 时，字段长度最小 1 字节，长度最大 120 字节
fields	string[]	指定返回的字段列表数组最小长度 1，最大长度 256 字段长度最小 1 字节，长度最大 64 字节
pagination_mode	enum	分页方式，[枚举详情] 枚举列表：{ PAGINATION_MODE_NORMAL, PAGINATION_MODE_CURSOR } 默认值：PAGINATION_MODE_NORMAL
page	integer	搜索页码，普通翻页模式使用最小值 1，最大值 1000 默认值：1
page_size	integer	一页显示的数据条数最小值 1，最大值 100 默认值：10
cursor	integer	游标值，游标翻页模式使用，第一次拉取无需填写、后续拉取传递上一次返回的 cursor 数值最小值 1

使用说明

对广告主而言，account_id 必填；对于代理商而言，account_id 选填；如未传 account_id，则默认拉取该代理商下属所有子客信息。
filtering 参数仅在代理商获取子客广告主信息时生效。
服务商运营人员授权得到的 access_token 使用此接口只能拉取到权限范围内的账号（非服务商下的全部账号），如有需要请改用服务商管理员授权的 access_token。
普通翻页模式仅支持查询前 1000 条数据，当请求数据超出此范围时请使用游标翻页模式查询。

请求示例


curl -G 'https://api.e.qq.com/v1.1/advertiser/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"corporation_name","operator":"EQUALS","values":["腾讯计算机系统有限公司"]}]' \
-d 'fields=["account_id"]' \
-d 'pagination_mode=PAGINATION_MODE_NORMAL' \
-d 'page=1' \
-d 'page_size=10'

应答字段

名称	类型	描述
list	struct[]	返回信息列表
account_id	integer	广告主帐号 id
daily_budget	integer	竞价广告账户日预算，单位为分，0 表示不设预算（即不限）
system_status	enum	客户系统状态，[枚举详情]
reject_message	string	审核消息
corporation_name	string	企业名称
corporation_licence	string	企业营业执照注册号
certification_image_id	string	营业执照/企业资质证明图片 id
certification_image	string	营业执照/企业资质证明图片 URL 地址
identity_number	string	身份证号码，如果帐号类型是企业，则为法人身份证号，如果帐号类型是个人，则为个人身份证号
individual_qualification	struct	个人身份证明
identification_front_image_id	string	身份证图片（正面）id，通过 [images 模块] 上传图片后获得
identification_back_image_id	string	身份证图片（反面）id，通过 [images 模块] 上传图片后获得
corporate_image_name	string	企业形象名称
corporate_image_logo	string	企业形象 LOGO
system_industry_id	integer	行业 id，详见 [行业分类]
customized_industry	string	调用方行业名称
introduction_url	string	业务介绍页地址，可填写公司网站、APP 下载页、H5 链接等，作为开户信息参考
corporate_brand_name	string	品牌名称
industry_qualification_image_id_list	string[]	行业资质图片 id 列表，通过 [images 模块] 上传图片后获得
industry_qualification_image	string[]	行业资质证明图片 URL 地址
ad_qualification_image_id_list	string[]	广告资质图片 id 列表，通过 [images 模块] 上传图片后获得
ad_qualification_image	string[]	广告特殊资质证明图片 URL 地址
contact_person	string	联系人姓名
contact_person_email	string	联系人 email
contact_person_telephone	string	联系人座机电话号码，格式为：区号-座机号，例如：0755-8601338
contact_person_mobile	string	联系人手机号码，例如：+8613900000000 或 13900000000
websites	struct[]	推广链接列表，当且仅当输入参数 account_id 不为空时有效
website_domain	string	推广链接域名，无需 http 前缀，如 www.qq.com
icp_image_id	string	网站 icp 备案证书扫描图片，通过 [images 模块] 上传图片后获得
system_status	enum	推广链接系统状态，[枚举详情]
reject_message	string	审核消息
mdm_id	integer	客户主体 id
mdm_name	string	客户主体名称
agency_account_id	integer	代理商 account_id
operators	struct[]	运营人员列表
operator_id	integer	运营人员 id
operator_name	string	运营人员名称
qq	integer	登录 QQ 号码
wechat_account_id	string	微信账号 id
is_master	boolean	是否是主要运营人员，true：是，false：否
memo	string	账户备注
area_code	integer	公司所在地，具体值参照附录中的 [地域信息]
is_local_business	boolean	是否为附近推账号
page_info	struct	分页配置信息，普通翻页模式返回
page	integer	搜索页码
page_size	integer	一页显示的数据条数
total_number	integer	总条数
total_page	integer	总页数
cursor_page_info	struct	分页配置信息，游标翻页模式返回
page_size	integer	一页显示的数据条数
total_number	integer	总条数
has_more	boolean	是否有下一页，返回 has_more=false 时表示已无下一页，会同时返回 cursor=null，此时应停止拉取
cursor	integer	下一次拉取的游标值

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "account_id": "<ACCOUNT_ID>",
                "daily_budget": 2000,
                "system_status": "CUSTOMER_STATUS_NORMAL",
                "reject_message": "Reject message example",
                "corporation_name": "腾讯计算机系统有限公司",
                "corporation_licence": "888888888888888888",
                "certification_image_id": "<IMAGE_ID>",
                "certification_image": "https://tencent.com/certification_example.png",
                "identity_number": "",
                "individual_qualification": {
                    "identification_front_image_id": "<IMAGE_ID>",
                    "identification_back_image_id": "<IMAGE_ID>"
                },
                "corporate_image_name": "腾讯",
                "corporate_image_logo": "https://tencent.com/logo_example.png",
                "system_industry_id": 21474840687,
                "introduction_url": "https://www.tencent.com",
                "industry_qualification_image_id_list": [
                    "<IMAGE_ID>"
                ],
                "industry_qualification_image": [
                    "https://tencent.com/qualification_example.png"
                ],
                "ad_qualification_image_id_list": [
                    "<IMAGE_ID>"
                ],
                "contact_person": "Name",
                "contact_person_email": "example@qq.com",
                "contact_person_telephone": "0755-86013388",
                "contact_person_mobile": "13900000000",
                "websites": [
                    {
                        "website_domain": "www.tencent.com",
                        "icp_image_id": "<IMAGE_ID>",
                        "system_status": "WEBSITE_STATUS_DENIED",
                        "reject_message": "Reject message example"
                    }
                ],
                "operators": [],
                "memo": "账户备注",
                "area_code": "110100",
                "is_local_business": false
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        },
        "cursor_page_info": {
            "page_size": 10,
            "total_number": 1
        }
    }
}

可视化调试工具

问题仍未解决？

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

查询微信公众平台广告主基础信息
全部接口
V1.1
loading

所属权限
请求地址	wechat_advertiser/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 中的字段。如不填写，则根据默认值进行返回

请求参数

标有*的参数为必填项

名称	类型	描述
page	integer	搜索页码，获取指定页数据，大于等于 1，小于等于实际总页数，若不传则视为 1 最小值 1，最大值 99999
page_size	integer	一页获取的数据条数，1-100，默认为 10 最小值 1，最大值 100

请求示例


curl -G 'https://api.e.qq.com/v1.1/wechat_advertiser/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'page=1' \
-d 'page_size=10'

应答字段

名称	类型	描述
list	struct[]	返回信息列表
account_id	integer	广告主 id，有操作权限的广告主 id
wechat_account_id	string	微信帐号 id
page_info	struct	分页配置信息
page	integer	搜索页码，获取指定页数据，大于等于 1，小于等于实际总页数，若不传则视为 1
page_size	integer	一页获取的数据条数，1-100
total_number	integer	总条数
total_page	integer	总页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "account_id": 1234567,
                "wechat_account_id": "wxeec1234567c897d2"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

可视化调试工具

问题仍未解决？

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

查询商务管家账号下广告主信息
全部接口
V1.1
loading

所属权限	Account Management,Ads Management,Ads Insights,Audience Management,User Actions
请求地址	business_manager_relations/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 中的字段。如不填写，则根据默认值进行返回

请求参数

标有*的参数为必填项

名称	类型	描述
page	integer	搜索页码，默认值：1 最小值 1，最大值 99999
page_size	integer	一页显示的数据条数，默认值：10 最小值 1，最大值 100
advertiser_type	integer	广告主类型筛选，不筛选则不传该字段，若只需要直客传 1，若只需要子客则传 2 最小值 1，最大值 2

使用说明

该接口仅支持 BM 账号 token 进行操作。

请求示例


curl -G 'https://api.e.qq.com/v1.1/business_manager_relations/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'page=1' \
-d 'page_size=10'

应答字段

名称	类型	描述
list	struct[]	返回信息列表
account_id	integer	推广帐号 id，有操作权限的帐号 id，包括代理商和广告主帐号 id
corporation_name	string	企业名称
account_type	enum	商务管家账号类型，[枚举详情]
page_info	struct	分页配置信息
page	integer	搜索页码
page_size	integer	一页显示的数据条数
total_number	integer	总条数
total_page	integer	总页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "account_id": "<ACCOUNT_ID>",
                "corporation_name": "腾讯计算机系统有限公司"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

可视化调试工具

问题仍未解决？

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

查询微信公众平台服务商详情信息
全部接口
V1.1
loading

所属权限
请求地址	wechat_agency/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,必填

使用说明

获取微信服务商广告账户信息，只允许微信服务商调用。

请求示例


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

应答字段

名称	类型	描述
account_id	integer	推广帐号 id，代理商账号 id,必填
wechat_account_id	string	微信账号 id：若为微信公众号则为微信公众号 id，若为通用账号则为通用账号 id。
wechat_account_name	string	微信账号名称：若为微信公众号则为微信公众号名称，若为通用账号则为通用账号名称。
corporation_name	string	企业名称
admin_name	string	超级管理员名称
admin_phone_number	string	管理员联系电话，格式为：区号-座机号，例如：0755-8601338
admin_wechat_id	string	超级管理员微信号
certification_image	string	营业执照/企业资质证明图片 URL 地址
corporation_licence	string	企业营业执照注册号
advertiser_info_spec	struct	关联的子客信息
status_pre_authorization_number	integer	预授权广告主数量
status_confirm_authorization_number	integer	已授权广告主数量
status_request_cancelation_number	integer	请求撤销授权广告主数量

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "account_id": "<ACCOUNT_ID>",
        "corporation_name": "腾讯计算机系统有限公司",
        "certification_image": "https://tencent.com/certification_example.png",
        "corporation_licence": "Corporation licence",
        "advertiser_info_spec": []
    }
}

可视化调试工具

问题仍未解决？

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

【待废弃，请使用新接口 wechat_advertiser_specification/get 】查询微信公众平台广告主详情信息
全部接口
V1.1
loading

所属权限
请求地址	wechat_advertiser_detail/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，直客客户必须填写，代理商可不填写; 如代理商不填写，则获取代理商下全部子客户的信息
filtering	struct[]	过滤条件，若此字段不传，或传空则视为无限制条件，详见 [过滤条件] 数组最小长度 1，最大长度 10
field*	string	过滤字段可选值：{ wechat_account_name, corporation_name, system_industry_id, wechat_account_id, account_type, auth_status }
operator*	enum	操作符当 field 取值 wechat_account_name 时，枚举列表：{ CONTAINS } 当 field 取值 corporation_name 时，枚举列表：{ CONTAINS } 当 field 取值 wechat_account_id 时，枚举列表：{ EQUALS, IN } 当 field 取值 system_industry_id 时，枚举列表：{ EQUALS, IN } 当 field 取值 account_type 时，枚举列表：{ EQUALS } 当 field 取值 auth_status 时，枚举列表：{ EQUALS }
values*	string[]	字段取值，values 数组的个数限制与 operator 的取值相关，详见 [过滤条件] 当 field 取值 wechat_account_name 时，字段长度最小 1 字节，长度最大 120 字节当 field 取值 corporation_name 时，字段长度最小 1 字节，长度最大 120 字节当 field 取值 wechat_account_id 时，字段长度最小 1 字节，长度最大 120 字节当 field 取值 wechat_account_id 且 operator 取值 IN 时，字段长度最小 1 字节，长度最大 120 字节当 field 取值 account_type 时，枚举列表：{ ACCOUNT_TYPE_OFFICIAL_ACCOUNTS, ACCOUNT_TYPE_MINI_PROGRAM, ACCOUNT_TYPE_MINI_GAME } 当 field 取值 auth_status 时，枚举列表：{ STATUS_PRE_AUTHORIZATION, STATUS_CONFIRM_AUTHORIZATION, STATUS_REQUEST_CANCELATION }
page	integer	搜索页码，默认值：1 最小值 1，最大值 99999
page_size	integer	一页显示的数据条数，默认值：10 最小值 1，最大值 100

使用说明

获取微信服务商子客账户信息，暂不支持微信直客广告主调用。

请求示例


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

应答字段

名称	类型	描述
list	struct[]	返回信息列表
account_id	integer	推广帐号 id
wechat_account_name	string	微信账号名称：若为微信公众号则为微信公众号名称，若为通用账号则为通用账号名称。
system_industry_id	integer	行业 id，详见 [行业分类]
wechat_account_id	string	微信账号 id：若为微信公众号则为微信公众号 id，若为通用账号则为通用账号 id。
account_type	enum	微信广告账户类型，[枚举详情]
corporation_name	string	企业名称
auth_status	enum	微信广告账户授权状态，[枚举详情]
auth_time	integer	授权时间（时间戳），大于等于 0，无授权则为 0
agency_id_list	integer[]	关联服务商 id 列表
staff_wechat_id_list	string[]	关联的运营人员微信号列表
daily_budget	integer	日限额，单位为分，日预算需介于 5,000 分-400,000,000 分之间（50 元-4,000,000 元，单位为人民币）；每次修改幅度不能低于该 adgroup 今日已消耗金额加上 5,000 分（50 元，单位为人民币）；每次修改幅度不能低于 5,000 分（50 元，单位为人民币）；每天每广告组最多修改 1,000 次。
page_info	struct	分页配置信息
page	integer	搜索页码
page_size	integer	一页显示的数据条数
total_number	integer	总条数
total_page	integer	总页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "account_id": "<ACCOUNT_ID>",
                "system_industry_id": 21474840687,
                "corporation_name": "腾讯计算机系统有限公司",
                "agency_id_list": [],
                "staff_wechat_id_list": []
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

可视化调试工具

问题仍未解决？

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

首页

开发文档

最新动态

腾讯广告

广告帐号 (Advertiser) V1.1 loading

添加腾讯广告服务商子客 全部接口 V1.1 loading

全局参数

特定请求头参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

更新腾讯广告广告主信息 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

查询腾讯广告广告主信息 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

查询微信公众平台广告主基础信息 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

查询商务管家账号下广告主信息 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

查询微信公众平台服务商详情信息 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

【待废弃，请使用新接口 wechat_advertiser_specification/get 】查询微信公众平台广告主详情信息 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

广告帐号 (Advertiser)

V1.1

loading

添加腾讯广告服务商子客
全部接口
V1.1
loading

更新腾讯广告广告主信息
全部接口
V1.1
loading

查询腾讯广告广告主信息
全部接口
V1.1
loading

查询微信公众平台广告主基础信息
全部接口
V1.1
loading

查询商务管家账号下广告主信息
全部接口
V1.1
loading

查询微信公众平台服务商详情信息
全部接口
V1.1
loading

【待废弃，请使用新接口 wechat_advertiser_specification/get 】查询微信公众平台广告主详情信息
全部接口
V1.1
loading