Method: customers.analysisQueries.validate

對提供的分析查詢執行靜態驗證檢查。

HTTP 要求

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

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

路徑參數

參數
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 Data Hub 客戶 ID。預設值為所有已連結的客戶。已淘汰，在 query_execution_spec 中使用 adsDataCustomerId。
matchDataCustomerId
(deprecated)

string (int64 format)

選用，用來驗證比對資料和臨時資料表存取權的特定廣告資料中心客戶 ID。預設值為所有已連結的客戶。已淘汰，使用 query_execution_spec 中的 match_table_customer_id。
spec

object (QueryExecutionSpec)

選用，query_execution_spec 中的重複欄位會覆寫外部欄位。
includePerformanceInfo

boolean

選用，如為 true，則請呼叫 BigQuery 來模擬查詢，以收集部分效能資訊。相較於驗證查詢，這項作業可能需要較長的時間。模擬測試需要設定 query_execution_spec 中的 startDate、endDate 和參數。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

對 analyticsQuery.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，則傳回此值。將處理處理的位元組四捨五入為 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