Method: exchanges.generateReport

レポート ID を生成して返します。レポートは保持されません。同じリクエストで呼び出しを行うと、レポートは再生成されます。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 の場合、これがデフォルトのディメンションです。