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 概览。

ReportType

报告类型。

枚举
REPORT_TYPE_UNSPECIFIED 未指定报告类型，输入值无效
HOURLY 报告类型：每小时。
DAILY 每日报告类型。
WEEKLY 每周报告类型。
MONTHLY 报告类型：每月。

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），则这就是默认维度。