REST Resource: customers.analysisQueries

Tài nguyên: AnalyzeQuery

Xác định truy vấn phân tích có thể được thực thi trong Ads Data Hub.

Biểu diễn dưới dạng 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.
}
Các trường
name

string

Tên xác định duy nhất một truy vấn. Nó có dạng customer/[customerId]/AnalysisQueries/[resource_id], ví dụ: &g/39;customer/123/AnalyzeQueries/abcd1234&33; Mã tài nguyên do máy chủ tạo.
title

string

Tiêu đề truy vấn là tên duy nhất trong một khách hàng Ads Data Hub và loại truy vấn.
queryText

string

Văn bản truy vấn được viết bằng SQL chuẩn. Hãy xem https://cloud.google.com/bigquery/docs/reference/standard-sql/.
parameterTypes

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

Mọi tham số bổ sung mà truy vấn mong đợi. Liên kết từng tên đối số với loại đối số.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
mergeSpec
(deprecated)

object (MergeSpec)

Hướng dẫn hợp nhất hàng. Nếu có, thì bất kỳ hàng nào đã bị loại bỏ vì lý do về quyền riêng tư sẽ được kết hợp thành một hàng hợp nhất. Hàng đã hợp nhất sẽ nằm trong kết quả cuối cùng nếu hàng hợp nhất đáp ứng các yêu cầu về quyền riêng tư.
queryState

enum (QueryState)

Trạng thái truy vấn.
updateTime

string (Timestamp format)

Lần truy vấn gần đây nhất được cập nhật.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu" với độ phân giải nano giây và tối đa chín chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateEmail

string

Địa chỉ email của người dùng gần đây nhất đã cập nhật truy vấn.
createTime

string (Timestamp format)

Thời gian truy vấn được tạo.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu" với độ phân giải nano giây và tối đa chín chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
createEmail

string

Địa chỉ email của người dùng đã tạo truy vấn.
queryShare[]

object (QueryShare)

Cho biết rằng có thể chia sẻ một truy vấn ra ngoài khách hàng Ads Data Hub.
Trường liên kết filtered_row. Hướng dẫn hợp nhất hàng. filtered_row chỉ có thể là một trong những giá trị sau:
filteredRowSummary

object (FilteredRowSummary)

Xác định cách kết hợp các hàng được thả vì lý do bảo mật thành một hàng hợp nhất. Hàng hợp nhất sẽ được đưa vào kết quả cuối cùng nếu hàng được hợp nhất đáp ứng yêu cầu về quyền riêng tư.
generateFilteredRowSummaryAutomatically

boolean

Nếu đúng, một bản tóm tắt hàng đã lọc sẽ được tạo tự động.

MergeSpec

Hợp nhất hướng dẫn cho giản đồ kết quả truy vấn phân tích.

Biểu diễn dưới dạng JSON 
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
Các trường
columns

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

Hướng dẫn hợp nhất từng cột (được đặt tên theo tên). Mọi cột bị thiếu sẽ được coi là ERROR_TYPE_UNSPECIFIED.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

MergeColumn

Hợp nhất hướng dẫn cho một cột đầu ra.

Biểu diễn dưới dạng JSON 
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
Các trường
type

enum (MergeType)

Phương thức dùng để kết hợp các giá trị cho cột.
value

object (ParameterValue)

Giá trị không đổi cần sử dụng (chỉ hợp lệ cho loại hợp nhất CONSTANT).

Kiểu hợp nhất

Tất cả các thao tác được hỗ trợ để hợp nhất cột.

Enum
MERGE_TYPE_UNSPECIFIED Loại hợp nhất không xác định. Giá trị cột đã hợp nhất sẽ là NULL.
CONSTANT Thay thế giá trị cột đã hợp nhất bằng hằng số đã cho.
SUM Lấy tổng giá trị cột hợp nhất.

Tóm tắt hàng đã lọc

Hợp nhất hướng dẫn cho giản đồ kết quả truy vấn phân tích.

Biểu diễn dưới dạng JSON 
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
Các trường
columns

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

Hướng dẫn hợp nhất từng cột (được đặt tên theo tên). Mọi cột bị thiếu sẽ được coi là SUMMARY_TYPE_UNSPECIFIED.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CộtTóm tắt

Hợp nhất hướng dẫn cho một cột đầu ra.

Biểu diễn dưới dạng JSON 
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
Các trường
type

enum (SummaryType)

Phương thức dùng để kết hợp các giá trị cho cột.
value

object (ParameterValue)

Giá trị không đổi cần sử dụng (chỉ hợp lệ cho loại tóm tắt CONSTANT).

Loại tóm tắt

Tất cả các thao tác được hỗ trợ để hợp nhất cột.

Enum
SUMMARY_TYPE_UNSPECIFIED Loại tóm tắt không xác định. Giá trị của cột tóm tắt sẽ là NULL.
CONSTANT Thay thế giá trị cột đã hợp nhất bằng hằng số đã cho.
SUM Lấy tổng giá trị cột hợp nhất.

Phương pháp

create

 Tạo một truy vấn phân tích để thực thi sau đó.

delete

 Xóa một truy vấn phân tích.

get

 Truy xuất truy vấn phân tích được yêu cầu.

list

 Liệt kê các truy vấn phân tích thuộc sở hữu của khách hàng được chỉ định.

patch

 Cập nhật truy vấn phân tích hiện có.

start

 Bắt đầu thực thi một truy vấn phân tích đã lưu trữ.

startTransient

 Bắt đầu thực thi một truy vấn phân tích tạm thời.

validate

 Thực hiện kiểm tra xác thực tĩnh trên truy vấn phân tích được cung cấp.