Method: customers.analysisQueries.start

開始對已儲存的分析查詢執行。系統會將結果寫入指定的 BigQuery 目的地資料表。傳回的作業名稱可用來輪詢查詢完成狀態。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

完整資源名稱,例如 'customers/123/analysisQuery/abcd1234'。

要求主體

要求主體的資料會採用以下結構:

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

object (QueryExecutionSpec)

定義查詢執行參數。

destTable

string

查詢結果的目的地 BigQuery 資料表,格式為「##9;project.dataset.table_name'」。指定時,專案必須明確加入許可清單客戶的 ADH 帳戶。如未指定專案,請使用客戶適用的預設專案。如果未指定專案或資料集,請使用預設專案和資料集。

customerId

string (int64 format)

選用,廣告資料中心客戶執行查詢。如未指定,則預設為查詢擁有者的客戶。

回應主體

如果成功,回應主體會包含 Operation 的執行例項。

授權範圍

需要下列 OAuth 範圍:

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