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)

(選用步驟) 系統會根據這份維度清單生成報表。如果為空值，則只會納入發布商 ID。如果特定類型的報表不支援這些維度，系統就會忽略。

回應主體

如果成功，回應主體會包含 Report 的執行個體。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。

ReportType

報表類型。

列舉
REPORT_TYPE_UNSPECIFIED 未指定報表類型，輸入值無效。
HOURLY 每小時報表類型。
DAILY 每日報表類型。
WEEKLY 每週報告類型。
MONTHLY 每月報表類型。
AWBID_DAILY AwBid Daily 報表類型。
AWBID_WEEKLY AwBid 每週報表類型。
AWBID_MONTHLY AwBid 月報表類型。
AWBID_OUT_OF_MONTH_IVT AwBid out of month IVT 報表類型。

DimensionId

Report DimensionId 列舉。

列舉
DIMENSION_ID_UNSPECIFIED 報表維度未指定，輸入值無效。
PARTNER_ID 合作夥伴 ID，僅適用於每日報表。
DEVICE_TYPE 裝置類型，僅支援每日報表。
CREATIVE_ID 廣告素材 ID，僅支援每日報表。請注意，這個維度可能會大幅增加報表的檔案大小。包含這項維度的報表可能需要數小時才能製作完成。日後，我們將限制這些高負載欄位的評分。
CREATIVE_TYPE 廣告素材類型，僅支援每日報表。請注意，這個維度可能會大幅增加報表的檔案大小，且包含這個維度的報表可能需要數小時才能執行。日後我們將限制這些高負載欄位的評估。
REGION_CODE 國家/地區代碼，僅適用於每日報表。
DEAL_ID 交易 ID (對應至廣告空間來源)，僅支援每日報表。
PUBLISHER_ID 發布商 ID (如果輸入的維度 ID 清單為空值，這是預設維度)。