Method: customers.userListQueries.validate

對所提供的使用者名單查詢執行靜態驗證檢查。

HTTP 要求

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

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

路徑參數

參數
parent

string

擁有查詢的父項資源名稱,例如 'customers/123'。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "query": {
    object (UserListQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
欄位
query

object (UserListQuery)

要驗證的查詢。

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 和參數。

回應主體

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

回應 userListQuery.validate 要求。

JSON 表示法
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  }
}
欄位
processedBytes
(deprecated)

string (int64 format)

已淘汰,請改用 queryPerformanceInfo。這項查詢讀取的資料位元組數。如要進一步瞭解計算方式,請參閱 https://cloud.google.com/bigquery/pricing#data。如果 includePerformanceInfo 為 True,則傳回此值。將處理處理的位元組四捨五入為 MB,然後轉換成位元組。設為 -1 表示我們無法擷取這項查詢內容。

queryPerformanceInfo

object (QueryPerformanceInfo)

如果 includePerformanceInfo 為 True,則傳回此值。

授權範圍

需要下列 OAuth 範圍:

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