【注意事项】快手广告计划/快手广告组/快手广告创意报表查询接口，如果单次查询需要处理的有效快手广告计划/快手广告组/快手广告创意数量超过5000，会提示“报表查询处理ID数比较多，请分批次传ID进行查询”。其中，“有效广告计划/广告组/广告创意数量”以请求的实际结果为准，并非快手账户里广告计划/广告组/广告创意的整体数量。
为了保证更稳定、更的报表数据查询，现新增历史投放报表数据接口，支持以异步任务的方式查询历史数据。原有的实时报表接口时间范围调整为近7天（含当天），历史投放报表接口时间范围为近12个月（含当天）；分时查询仅支持近7天（含当天）的数据。由于投放后台可查询时间范围近期有变动，Marketing API会尽快对齐。
1. 新增权限code
report_service（获取快手广告账户报表信息）
需要在授权URL的scope参数上添加 report_service，进行授权后才能访问获取快手信息流广告账户报表信息的接口，示例如下：
https://ad.e.kuaishou.com/openapi/oauth?app_id=1&scope=%5B%22report_service%22%5D&redirect_uri=https://e.kuaishou.com&state=abc
2. 报表查询
2.1 快手广告主数据（实时）
1） 请求快手广告主数据
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/report/account_report
请求方式：POST
数据格式：JSON
字段
类型
描述
advertiser_id
long
快手广告主ID（注：非账户快手ID），在获取accessToken时返回
start_date_min（必选其1）
string
增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】
可选时间范围参见文档上方说明
end_date_min（必选其1）
string
增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】
可选时间范围参见文档上方说明
start_date（必选其2）
string
过滤筛选条件，格式yyyy-MM-dd
可选时间范围参见文档上方说明
end_date（必选其2）
string
过滤筛选条件，格式yyyy-MM-dd
可选时间范围参见文档上方说明
temporal_granularity（可选）
string
天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据
report_dims（可选）
string[]
"adScene"：按广告场景；不传/传空/传空数组：不限
page
int
请求的页码，默认为 1
page_size
int
每页行数，默认为20，更大支持2000
本文标题：快手推广平台API对接：报表查询模块《*》
本文链接：https://www.eatui.cn/xinxiliu/17981.html
