查询资金账户日结算明细（新）-资金账户日结算明细-财务管理-Marketing API-鲸鸿动能广告（中国大陆地区）

【简介】查询广告主或服务商的日结算明细，包括现金、赠送、返利账户分别支出的信息

请求地址

https://ads.cloud.huawei.com/openapi/v1/finance/consume/query

请求方法

GET

参数名称	类型	是否必选	描述
advertiser_id	long	否	广告主ID，使用经理账户登录或授权账号关联了多个子客账户时，此字段必填： 1、若一级服务商登录： i.传一级服务商直属子客，则查询一级服务商直属子客的消耗 ii.传子客服务商直属子客，则查询子客服务商直属子客的消耗 2、若子客服务商登录： i.传子客服务商直属子客，则查询子客服务商直属子客的消耗
agency_id	long	否	服务商ID，服务商登录时，可选填写该字段 1、若一级服务商登录： i.传自身或不传，则查询一级服务商的所有消耗（同时不传advertiser_id） ii.传子客服务商，则查询子客服务商的所有消耗（同时不传advertiser_id） 2、若子客服务商登录： i.传自身或不传，则查询子客服务商的所有消耗（同时不传advertiser_id）
start_date	string	是	起始时间 yyyy-MM-dd
end_date	string	是	结束时间 yyyy-MM-dd 时间跨度最大一年
account_type	string	是	账户类型标识详见【资金账户类型】
account_media_type	string	否	适用媒体范围，不填默认查全部适用媒体范围详见【虚拟账户类型】
sign_party	string	否	签约主体（不传查全部），详见签约主体。
user_service_type	string	否	账户推广业务类型，不填默认查询ADS侧数据，详见【账户推广业务类型】

请求示例

GET openapi/v1/finance/consume/query HTTP/1.1

Accept:application/json

Content-Type:application/json

Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soYIZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=

{
    "start_date": "2025-12-18",
    "end_date": "2026-02-08",
    "account_type": "ALL_ACCOUNT",
    "account_media_type": "GENERIC_ACCOUNT",
    "agency_id": "1765860043678498432",
    "advertiser_id": "",
    "sign_party": "HW_SOFT",
    "user_service_type": "ADS"
}

响应字段

参数名称	类型	描述
code	string	返回码
message	string	返回描述
data	Struct1[]	返回数据

Struct1定义

参数名称	类型	描述
date	string	日期 yyyy-MM-dd
consume	bigdecimal	当日支出
currency	string	币种
consume_detail	Struct2[]	分账户支出信息
account_media_type	string	适用媒体范围详见【虚拟账户类型】

Struct2定义

参数名称	类型	描述
account_type	string	账户类型标识详见【资金账户类型】
consume	bigdecimal	当日支出
currency	string	币种
sign_party	string	签约主体，详见签约主体。
gift_type	string	赠送金类型，详见赠送金类型

应答示例

HTTPS/1.1 200 OK
{
    "code": "200",
    "data": [
        {
            "date": "2026-02-02",
            "consume": 33.00000,
            "currency": "CNY",
            "account_media_type": "GENERIC_ACCOUNT",
            "consume_detail": [
                {
                    "account_type": "CASH_ACCOUNT",
                    "consume": 33.00000,
                    "currency": "CNY"
                }
            ]
        },
        {
            "date": "2026-02-05",
            "consume": 135.25000,
            "currency": "CNY",
            "account_media_type": "GENERIC_ACCOUNT",
            "consume_detail": [
                {
                    "account_type": "REBATE_ACCOUNT",
                    "consume": 46.50000,
                    "currency": "CNY"
                },
                {
                    "account_type": "GIFT_ACCOUNT",
                    "consume": 46.50000,
                    "currency": "CNY",
                    "gift_type": "PURE_GIFT"
                },
                {
                    "account_type": "GIFT_ACCOUNT",
                    "consume": 20.00000,
                    "currency": "CNY",
                    "gift_type": "RECHARGE_GIFT"
                },
                {
                    "account_type": "CASH_ACCOUNT",
                    "consume": 22.25000,
                    "currency": "CNY"
                }
            ]
        }
    ]
}