广告账户流水信息
获取广告账户流水信息。
请求地址
https://openapi.aiclk.com/openapi/v1/account_fund/list
所属权限
ads_read
请求方式
GET
请求参数
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| account_id | int | 是 | 广告主ID(广告投放平台的userID) |
| query | string | 是 | 请求参数结构,json格式,具体字段如下 |
query参数
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| start_date | string | 是 | 开始时间,例如:2021-05-01 |
| end_date | string | 是 | 结束时间,例如:2021-05-31 |
| page | int | 否 | 页码,默认为1 |
| page_size | int | 否 | 每页记录数,默认为10 |
| fields | []string | 是 | 需要的返回字段,允许值:"cash_cost","coupon_cost","compensation","date" |
请求示例
curl -X GET \
'https://openapi.aiclk.com/openapi/v1/account_fund/list?account_id=1000002&query={"page": 1,"page_size":5,"start_date": "2020-01-01","end_date": "2021-06-18","fields":["date","cash_cost","coupon_cost","compensation"]}' \
-H 'Host: openapi.aiclk.com' \
-H 'OGW_ACCESS_TOKEN: your_access_token'
返回字段释义
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | int | 返回码 |
| message | string | 返回信息 |
| data | json | 返回值,json格式,包含字段如下 |
| - list | object | 返回值列表 |
| -- cash_cost | int | 现金消耗,单位为分 |
| -- coupon_cost | int | 优惠券消耗,单位为分 |
| -- compensation | int | 赔付金额,单位为分 |
| -- date | string | 日期 |
| - page_info | object | 分页信息 |
| -- page | int | 页码 |
| -- page_size | int | 每页记录数 |
| -- total_number | int | 总记录数 |
返回示例
{
"code": 200,
"message": "success",
"data": {
"list": [
{
"cash_cost": 10000032,
"coupon_cost": 1000022,
"compensation": 1000000,
"date": "2021-05-01"
},
{
"cash_cost": 10000232,
"coupon_cost": 1000122,
"compensation": 1002000,
"date": "2021-05-02"
}
],
"page_info": {
"page": 1,
"page_size": 10,
"total_number": 12
}
}
}