Method: customers.analysisQueries.validate

提供された分析クエリに対して静的検証チェックを実行します。

HTTP リクエスト

POST https://adsdatahub.googleapis.com/v1/{parent=customers/*}/analysisQueries:validate

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

パスパラメータ

パラメータ
parent

string

クエリを所有する親リソース名。例: 'customers/123'

リクエスト本文

リクエストの本文には次の構造のデータが含まれます。

JSON 表現
{
  "query": {
    object (AnalysisQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
フィールド
query

object (AnalysisQuery)

検証するクエリ。

adsDataCustomerId
(deprecated)

string (int64 format)

(省略可)広告データの検証と一時テーブル アクセスに使用する、リンクされた Ads Ads Hub お客様 ID。デフォルトでは、リンクされているすべての顧客に表示されます。非推奨です。query_execution_spec 内で adsDataCustomerId を使用します。

matchDataCustomerId
(deprecated)

string (int64 format)

(省略可)マッチデータと検証テーブルへのアクセスの検証に使用する、リンクされた Ads Ads Hub お客様 ID。デフォルトでは、リンクされているすべての顧客に表示されます。非推奨です。query_execution_spec 内の match_table_customer_id を使用します。

spec

object (QueryExecutionSpec)

(省略可)query_execution_spec 内の重複するフィールドが、外側のフィールドより優先されます。

includePerformanceInfo

boolean

(省略可)true の場合、BigQuery を呼び出してクエリをドライランして、パフォーマンス情報を収集します。クエリを検証するだけの場合よりも時間がかかる可能性があります。ドライランには、startDate、endDate、query_execution_spec 内のパラメータを設定する必要があります。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

analyticsQueries.validate リクエストに対するレスポンス。

JSON 表現
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
フィールド
processedBytes
(deprecated)

string (int64 format)

サポートが終了し、代わりに queryPerformanceInfo を使用してください。このクエリが読み取るデータのバイト数。この計算方法の詳細については、https://cloud.google.com/bigquery/pricing#data をご覧ください。includePerformanceInfo が true の場合に返されます。Google は processBytes バイトを MB 単位に丸め、次にバイト単位に変換します。-1 は、このクエリで取得できなかったことを意味します。

queryPerformanceInfo

object (QueryPerformanceInfo)

includePerformanceInfo が true の場合に返されます。

filteredRowSummary

object (FilteredRowSummary)

クエリ実行時に使用される、フィルタされた行のサマリー詳しくは、https://developers.google.com/ads-data-hub/guides/filtered-row-summary をご覧ください。

認証スコープ

次の OAuth スコープが必要です。

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