获取无效赔付明细
全部接口
V1.1
loading
V1.1
loading
| 所属权限 | Ads Insight |
| 请求地址 | leads_invalid_pay/get |
| 请求方法 | 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 |
|
month*
|
string | 月份，格式 YYYY-MM 字段长度为 7 字节 |
使用说明
- 获取线索管理平台（http://leads.qq.com）无效线索赔付明细。说明：为保证接口使用的安全性避免调取他人的线索信息，该接口只可用于查询自己广告主下的线索赔付情况。
- 服务的沙箱环境正在建设中，近期即将上线。
- 接口暂时不支持 BM 角色调用。
- 本接口支持获取 2022 年 1 月份及后续每月无效赔付返款明细，当月赔付明细一般在次月 15 日左右可查询。若当月账号未满足确认赔付条件时，接口不返回任何值。具体未满足原因参考如下：
1)当月“参与赔付”线索 48 小时内标注数（线索状态=已转化、无效）／当月“参与赔付”线索总数小于 50%；
2)账户虽满足 48 小时内标记率大于等于 50%，但不存在线索状态标注结果未为无效-未接通或者接通状态为未接通的线索；
3)系统对线索状态标注结果未为无效-未接通或者接通状态为未接通的线索进行智能验证后，不存在空号、停机、关机线索；
4)线索上报账号和推广账号不一致，赔付明细请查看上报账号（归属账号）。
请求示例
curl 'https://api.e.qq.com/v1.1/leads_invalid_pay/get?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
"account_id": 123456,
"month": "2022-01"
}'
应答字段
| 名称 | 类型 | 描述 |
|---|---|---|
|
list
|
struct[] | 确认赔付信息 |
|
account_id
|
integer | 广告主账号 id |
|
account_name
|
string | 广告主名称 |
|
is_real_pay
|
boolean | 是否产生真实赔付：true-是，false-否 |
|
no_pay_reason
|
string | 未产生赔付的原因，未真实产生赔付时有值 |
|
pay_total_amount
|
float | 赔付总金额，单位：元 |
|
pay_details
|
struct[] | 确认赔付明细，未赔付是空列表 |
|
leads_id
|
integer | 线索 id |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"account_id": 123456,
"account_name": "账户名称 1",
"is_real_pay": true,
"pay_total_amount": 103.25,
"pay_details": [
{
"leads_id": 101
},
{
"leads_id": 102
}
]
},
{
"account_id": 223456,
"account_name": "账户名称 2",
"is_real_pay": false,
"pay_total_amount": 0,
"no_pay_reason": "本账号本月未满足无效赔付政策要求 48h 内线索标注率>=50%，导致“确认赔付”标签失效，不进行真实赔付。",
"pay_details": []
}
]
}
}可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
