Method: customers.userListQueries.start

开始对存储的用户列表查询执行查询。结果上传到指定的 Google Ads 用户名单。返回的操作名称可用于轮询查询完成状态。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

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

请求正文

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

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

object (QueryExecutionSpec)

定义查询执行参数。

userListId

string (int64 format)

Google Ads 用户名单 ID。请注意,用户列表必须由执行查询的广告数据中心客户管理。

customerId

string (int64 format)

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

响应正文

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

授权范围

需要以下 OAuth 范围:

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