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