REST Resource: customers.analysisQueries

資源：AnalyzeQuery

定義可在廣告資料中心內執行的分析查詢。

JSON 表示法 
{
  "name": string,
  "title": string,
  "queryText": string,
  "parameterTypes": {
    string: {
      object (ParameterType)
    },
    ...
  },
  "mergeSpec": {
    object (MergeSpec)
  },
  "queryState": enum (QueryState),
  "updateTime": string,
  "updateEmail": string,
  "createTime": string,
  "createEmail": string,
  "queryShare": [
    {
      object (QueryShare)
    }
  ],

  // Union field filtered_row can be only one of the following:
  "filteredRowSummary": {
    object (FilteredRowSummary)
  },
  "generateFilteredRowSummaryAutomatically": boolean
  // End of list of possible types for union field filtered_row.
}
欄位
name

string

查詢獨有的名稱。格式如下：customer/[customerId]/analysisQuery/[resource_id]，例如 'customers/123/analysisQuery/abcd1234'。資源 ID 是由伺服器產生，
title

string

查詢名稱，在單一廣告資料中心客戶和查詢類型中不得重複。
queryText

string

以標準 SQL 編寫的查詢文字。請參閱 https://cloud.google.com/bigquery/docs/reference/standard-sql/。
parameterTypes

map (key: string, value: object (ParameterType))

查詢所預期的任何其他參數。將每個引數名稱對應至其引數類型。

這個物件中包含 "key": value 組合的清單，例如：{ "name": "wrench", "mass": "1.3kg", "count": "3" }.
mergeSpec
(deprecated)

object (MergeSpec)

資料列合併的操作說明。如果有的話，則基於隱私權考量而遭捨棄的資料列將合併為單一合併資料列。如果合併的列符合隱私權規定，合併列會顯示在最後的輸出內容中。
queryState

enum (QueryState)

查詢狀態。
updateTime

string (Timestamp format)

查詢上次更新時間。

RFC3339 UTC 的「Zulu」格式時間戳記，單位為奈秒解析度，最多可達九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateEmail

string

上次更新查詢的使用者電子郵件地址。
createTime

string (Timestamp format)

查詢的建立時間。

RFC3339 UTC 的「Zulu」格式時間戳記，單位為奈秒解析度，最多可達九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
createEmail

string

建立查詢的使用者電子郵件地址。
queryShare[]

object (QueryShare)

表示共用某個廣告資料中心客戶可能共用的查詢方式。
聯集欄位 filtered_row。資料列合併的操作說明。filtered_row 只能是下列其中一項：
filteredRowSummary

object (FilteredRowSummary)

定義如何將基於隱私權考量而捨棄的資料列，合併為單一合併資料列。如果合併的資料列符合隱私權規定，系統會將合併的資料列納入最後的輸出內容。
generateFilteredRowSummaryAutomatically

boolean

設為 true 時，系統會自動產生篩選後的列摘要。

合併規格

合併分析查詢結果結構定義的操作說明。

JSON 表示法 
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
欄位
columns

map (key: string, value: object (MergeColumn))

合併每個資料欄的操作說明 (以名稱為索引鍵)。任何遺漏的欄都會視為 ency_TYPE_UNSPECIFIED。

這個物件中包含 "key": value 組合的清單，例如：{ "name": "wrench", "mass": "1.3kg", "count": "3" }.

合併欄

合併單一輸出資料欄的操作說明。

JSON 表示法 
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
欄位
type

enum (MergeType)

用於合併資料欄值的方法。
value

object (ParameterValue)

要使用的常數值 (僅適用於 CONSTANT 合併類型)。

合併類型

所有支援的資料欄合併作業。

列舉
MERGE_TYPE_UNSPECIFIED 未指定合併類型。合併的欄值為 NULL。
CONSTANT 將合併的欄值替換為指定常數。
SUM 加總合併資料欄值的總和。

篩選列摘要

合併分析查詢結果結構定義的操作說明。

JSON 表示法 
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
欄位
columns

map (key: string, value: object (ColumnSummaryRule))

合併每個資料欄的操作說明 (以名稱為索引鍵)。任何遺漏的資料欄都會視為 SUMMARY_TYPE_UNSPECIFIED。

這個物件中包含 "key": value 組合的清單，例如：{ "name": "wrench", "mass": "1.3kg", "count": "3" }.

資料欄摘要規則

合併單一輸出資料欄的操作說明。

JSON 表示法 
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
欄位
type

enum (SummaryType)

用於合併資料欄值的方法。
value

object (ParameterValue)

要使用的常數值 (僅適用於 CONSTANT 摘要類型)。

摘要類型

所有支援的資料欄合併作業。

列舉
SUMMARY_TYPE_UNSPECIFIED 未指定摘要類型。摘要欄值將會是 NULL。
CONSTANT 將合併的欄值替換為指定常數。
SUM 加總合併資料欄值的總和。

方法

create

 建立分析查詢以便稍後執行。

delete

 刪除分析查詢。

get

 擷取要求的分析查詢。

list

 列出指定客戶擁有的分析查詢。

patch

 更新現有的分析查詢。

start

 開始對已儲存的分析查詢執行。

startTransient

 開始執行暫時的分析查詢。

validate

 對提供的分析查詢執行靜態驗證檢查。