Queries: runquery

保存したクエリを実行してレポートを生成します。実習をご覧ください。

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId

パラメータ

パラメータ名 説明
パスパラメータ
queryId long 実行するクエリ ID。
省略可能なクエリ パラメータ
asynchronous boolean クエリを非同期で実行するかどうかを指定します。true の場合、このメソッドはすぐに返されます。false または未指定の場合、クエリはクエリの実行が終了するまで返されません。 (デフォルト: false)。

承認

このリクエストには、次のスコープによる認証が必要です。

スコープ
https://www.googleapis.com/auth/doubleclickbidmanager

詳細については、認証と認可のページをご覧ください。

リクエスト本文

リクエストの本文には、以下の構造を使用してデータを指定してください。

{
  "dataRange": string,
  "reportDataStartTimeMs": long,
  "reportDataEndTimeMs": long,
  "timezoneCode": string
}
プロパティ名 説明 メモ
dataRange string レポートの生成に使用されるレポート データ範囲。

有効な値は次のとおりです。
  • ALL_TIME
  • CURRENT_DAY
  • CUSTOM_DATES
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_365_DAYS
  • LAST_60_DAYS
  • LAST_7_DAYS
  • LAST_90_DAYS
  • MONTH_TO_DATE
  • PREVIOUS_DAY
  • PREVIOUS_HALF_MONTH
  • PREVIOUS_MONTH
  • PREVIOUS_QUARTER
  • PREVIOUS_WEEK
  • PREVIOUS_YEAR
  • QUARTER_TO_DATE
  • TYPE_NOT_SUPPORTED
  • WEEK_TO_DATE
  • YEAR_TO_DATE
reportDataStartTimeMs long レポートに表示されるデータの開始時間。なお、dataRangeCUSTOM_DATES の場合は reportDataStartTimeMs が必須であり、それ以外の場合は無視されます。
reportDataEndTimeMs long レポートに表示されるデータの終了日時。なお、dataRangeCUSTOM_DATES の場合は reportDataEndTimeMs が必須であり、それ以外の場合は無視されます。
timezoneCode string レポートデータ時間の正規のタイムゾーン コード。デフォルトは America/New_York です。

レスポンス

成功した場合、このメソッドは空のレスポンス本文を返します。

実習

ライブデータでこのメソッドを呼び出してレスポンスを確認するには、以下の API Explorer を使用します。 または、スタンドアロンの Explorer をお試しください。