Reports: run

生成报表。立即试用

默认情况下,系统是异步生成报表的。您也可以同步生成小型报表。如果系统没有及时生成同步报表,也仍会返回报表文件,并异步处理报表。

请求

HTTP 请求

POST https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/reports/reportId/run

参数

参数名称 说明
路径参数
profileId long Campaign Manager 360 用户个人资料 ID。
reportId long 报表的 ID。
可选查询参数
synchronous boolean 如果已设置且值为 true,请尝试同步生成报表。(默认值:false

授权

此请求需要获得以下范围的授权:

范围
https://www.googleapis.com/auth/dfareporting

如需了解详情,请参阅身份验证和授权页面。

请求正文

请勿使用此方法提供请求正文。

响应

如果成功,此方法将返回具有以下结构的响应正文:

{
  "kind": "dfareporting#file",
  "etag": etag,
  "reportId": long,
  "id": long,
  "lastModifiedTime": long,
  "status": string,
  "fileName": string,
  "format": string,
  "dateRange": {
    "kind": "dfareporting#dateRange",
    "startDate": date,
    "endDate": date,
    "relativeDateRange": string
  },
  "urls": {
    "browserUrl": string,
    "apiUrl": string
  }
}
属性名称 说明 备注
kind string 标识所属资源种类。值:固定字符串 "dfareporting#file"
etag etag 此资源的 ETag。
reportId long 生成此文件的报表的 ID。
id long 此报表文件的唯一 ID。
lastModifiedTime long 此文件最后一次修改的时间戳(单位为毫秒,自纪元开始的时间算起)。
status string 报表文件的状态。

可接受的值包括:
  • CANCELLED
  • FAILED
  • PROCESSING
  • REPORT_AVAILABLE
fileName string 文件的名称。
format string 报表的输出格式,仅在提供报表文件后可用。

可接受的值包括:
  • CSV
  • EXCEL
dateRange nested object 文件内报表数据的日期范围。该日期范围始终是生成报表的绝对日期范围。
dateRange.kind string 所属资源种类,在本例中为 dfareporting#dateRange
dateRange.startDate date 日期范围的开始日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
dateRange.endDate date 日期范围的结束日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
dateRange.relativeDateRange string 相对于报表生成日期的日期范围。

可接受的值包括:
  • LAST_14_DAYS
  • LAST_24_MONTHS
  • LAST_30_DAYS
  • LAST_365_DAYS
  • LAST_60_DAYS
  • LAST_7_DAYS
  • LAST_90_DAYS
  • MONTH_TO_DATE
  • PREVIOUS_MONTH
  • PREVIOUS_QUARTER
  • PREVIOUS_WEEK
  • PREVIOUS_YEAR
  • QUARTER_TO_DATE
  • TODAY
  • WEEK_TO_DATE
  • YEAR_TO_DATE
  • YESTERDAY
可写入
urls object 可以下载已完成的报表文件的网址。
urls.browserUrl string 用于通过浏览器下载报表数据的网址。
urls.apiUrl string 用于通过 API 下载报表数据的网址。

试试看!

使用下面的 API Explorer 对实际数据调用此方法,然后查看响应。