Method: exchanges.generateReport

生成并返回报告 ID。报告未持久保存。如果调用时使用相同的请求，系统将重新生成报告。

HTTP 请求

POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport

网址采用 gRPC 转码语法。

路径参数

参数
exchange

string

必需。报告所属的广告交易平台的名称。示例：“exchanges/123”。必需。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
字段
startDate

string

必需。报告的开始日期，采用 ISO_8601 格式 YYYY-MM-DD，包含在内。需要作为输入。
endDate

string

必需。报告的结束日期，采用 ISO_8601 格式 YYYY-MM-DD，包含在内。需要作为输入。
reportType

enum (ReportType)

必需。如果未指定报告类型，则会返回错误。
dimensionIds[]

enum (DimensionId)

可选。将用于生成报告的维度列表。如果为 null，则仅包含发布商 ID。如果特定类型的报告不支持某些维度，系统会忽略这些维度。

响应正文

如果成功，则响应正文包含一个 Report 实例。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/doubleclickbidmanager

如需了解详情，请参阅 OAuth 2.0 Overview。

ReportType

报告类型。

枚举
REPORT_TYPE_UNSPECIFIED 未指定报告类型，输入值无效。
HOURLY 一种每小时报告类型。
DAILY 一种每日报告类型。
WEEKLY 每周报告类型。
MONTHLY 一种月度报告类型。
AWBID_DAILY AwBid 日报类型。
AWBID_WEEKLY 一种 AwBid 周报告类型。
AWBID_MONTHLY AwBid 月度报告类型。
AWBID_OUT_OF_MONTH_IVT 一种 AwBid 月外 IVT 报告类型。

DimensionId

报告 DimensionId 枚举。

枚举
DIMENSION_ID_UNSPECIFIED 未指定报告维度，输入值无效。
PARTNER_ID 合作伙伴 ID，仅在每日报告中受支持。
DEVICE_TYPE 设备类型，仅在每日报告中受支持。
CREATIVE_ID 广告素材 ID，仅在每日报告中受支持。请注意，此维度可能会显著增加报告的文件大小。包含此维度的报告可能需要数小时才能运行。未来，我们将限制这些高负荷字段的评级。
CREATIVE_TYPE 广告类型，仅在每日报告中受支持。请注意，此维度可能会显著增加报告的文件大小。包含此维度的报告可能需要数小时才能运行。未来，我们将限制这些高负荷字段的评级。
REGION_CODE 国家/地区代码，仅在每日报告中受支持。
DEAL_ID 与广告资源来源对应的交易 ID，仅在每日报告中受支持。
PUBLISHER_ID 发布商 ID（如果输入维度 ID 列表为 null，则这是默认维度）。