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)

（可选）用于验证广告数据和临时表访问权限的关联广告数据中心客户 ID。默认为所有关联的客户。已弃用。在 query_execute_spec 内使用 adsDataCustomerId。
matchDataCustomerId
(deprecated)

string (int64 format)

（可选）用于验证匹配数据和临时表访问权限的具体关联广告数据中心客户 ID。默认为所有关联的客户。已弃用。在 query_execute_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，则返回此值。我们将 processingBytes 四舍五入为 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