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