名称 | 类型 | 描述 |
---|---|---|
account_id* | integer | 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id |
level* | string | 获取实时消耗的类型级别 可选值:{ ADVERTISER, CAMPAIGN, ADGROUP } |
date* | string | 日期,查询日期,日期格式:YYYY-MM-DD,只支持今天的数据查询 字段长度为 10 字节 |
filtering | struct[] | 过滤条件,过滤条件,当 level=CAMPAIGN 或 ADGROUP 时,该字段必填;若此字段不传,或传空则视为无限制条件,详见 [过滤条件] 数组最小长度 1,最大长度 2 |
field* | string | 过滤字段,当 level 为 CAMPAIGN 时,field 仅可选择 campaign_id ;当 level 为 ADGROUP 时,field 仅可选择 adgroup_id ; 可选值:{ adgroup_id, campaign_id } |
operator* | enum | 操作符 当 field 取值 adgroup_id 时,枚举列表:{ EQUALS } 当 field 取值 campaign_id 时,枚举列表:{ EQUALS } |
values* | string[] | 字段取值,values 数组的个数限制与 operator 的取值相关,详见 [过滤条件] |
page | integer | 搜索页码,默认值:1 最小值 1,最大值 99999 |
page_size | integer | 一页显示的数据条数,默认值:10 最小值 1,最大值 100 |
curl --location --request GET '/v1.3/realtime_cost/get' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'fields;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'level=ADGROUP' \
--data-urlencode 'date=2017-04-25' \
--data-urlencode 'filtering=[{"field":"adgroup_id","operator":"EQUALS","values":[111111111]}]' \
--data-urlencode 'page=1' \
--data-urlencode 'page_size=10'
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"campaign_id": "<CAMPAIGN_ID>",
"adgroup_id": "<ADGROUP_ID>",
"cost": 1300
}
],
"page_info": {
"page": 1,
"page_size": 10,
"total_number": 1,
"total_page": 1
}
}
}