Method: exchanges.generateReport

產生並傳回報表 ID。報表不會保留。如果叫用相同，就會重新產生報表。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
exchange

string

必要欄位。報表所屬的廣告交易平台名稱。例如：「Exchange/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

報表維度編號列舉。

列舉
DIMENSION_ID_UNSPECIFIED 未指定報表維度，輸入值無效。
PARTNER_ID 夥伴 ID，僅適用於每日報表。
DEVICE_TYPE 裝置類型 (僅適用於每日報表)。
CREATIVE_ID 廣告素材 ID (僅支援每日報表)。請注意，這個維度可能會對報表的檔案大小產生重大影響。此外，內含這個維度的報表可能需要數小時的執行時間。我們日後會限制這些載入大量欄位的評分。
CREATIVE_TYPE 廣告素材類型 (僅適用於每日報表)。請注意，這個維度可能會對報表的檔案大小產生重大影響。此外，內含這個維度的報表可能需要數小時的執行時間。我們日後會限制這些載入大量欄位的評分。
REGION_CODE 國家/地區代碼 (僅適用於每日報表)。
DEAL_ID 交易 ID (與廣告空間來源的對應) 僅適用於每日報表。
PUBLISHER_ID 發布商 ID。如果輸入維度 ID 清單為空值，此為預設維度。