查询账号自定义报表数据

请求地址

https://api.yeahtargeter.com/v1/google/account/report/query

请求方法

POST

请求Header

字段	类型	描述
Access_Token 必填	string	授权access-token，获取方法见接口文档【获取Access-Token】

请求参数

字段	类型	描述
customerIds 必填	List<string>	账号ID列表，最多10个
startDate 必填	string	开始时间和结束时间不得间隔超过30天； 格式为：yyyy-MM-dd
endDate 必填	string	开始时间和结束时间不得间隔超过30天； 格式为：yyyy-MM-dd
dimensions	List<string>	维度列表，默认维度 ：["customerId","day"] 支持的维度：支持维度
metrics	List<string>	指标列表，默认指标：["impressions","clicks","cost"] 支持的指标：支持指标

请求示例

{
    "customerIds": ["12344XXXX","1233XXXX"],
    "startDate": "2025-04-01",
    "endDate": "2025-04-30",
    "dimensions":["customerId","day"],
    "metrics":["impressions","clicks","cost"]
}

应答字段

仅返回有权限的账号数据

字段	类型	描述
code	number	返回码
message	string	返回信息
data		返回数据
customerId	string	账号id
customerName	string	账号名称
campaignId	string	广告系列id
campaignName	string	广告系列名称
day	string	日期,格式为：yyyy-MM-dd
impressions	number	展示
clicks	number	点击
cost	number	消耗（单位：美金）
requestId	number	请求id

应答示例

{
    "code": 200,
    "msg": "成功",
    "requestId": 291562262345598948,
    "data": {
        "totalCount": 2,
        "dataList": [
            {
                "customerId": "123123",
                "customerName": "广告账号名称",
                "campaignId": "123123",
                "campaignName": "广告系列名称",
                "day": "2025-04-01",
                "currency": "USD",
                "impressions": 12345,
                "clicks": 5,
                "cost": 1000.1 
            },
            {
                "customerId": "123123",
                "customerName": "广告账号名称",
                "campaignId": "123123",
                "campaignName": "广告系列名称",
                "day": "2025-04-02",
                "currency": "USD",
                "impressions": 12345,
                "clicks": 5,
                "cost": 1000.1 
            }
        ]
    }
}