Method: customers.analysisQueries.start

开始存储的分析查询。结果将写入指定的 BigQuery 目标表。返回的操作名称可用于轮询查询完成状态。

HTTP 请求

POST https://adsdatahub.googleapis.com/v1/{name=customers/*/analysisQueries/*}:start

网址采用 gRPC 转码语法。

路径参数

参数
name

string

完整资源名称,例如 'customers/123/analyticsQuery/abcd1234'。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "spec": {
    object (QueryExecutionSpec)
  },
  "destTable": string,
  "customerId": string
}
字段
spec

object (QueryExecutionSpec)

定义查询执行参数。

destTable

string

查询结果的 BigQuery 表,格式为 'project.dataset.table_name'。如果指定,则必须为客户的 ADH 帐号明确将项目列入白名单。如果未指定项目,则对提供的客户使用默认项目。如果未指定项目和数据集,则使用默认项目和数据集。

customerId

string (int64 format)

(可选)广告数据中心客户执行查询。如果未指定,则默认为拥有查询的客户。

响应正文

如果成功,响应正文将包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围:

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