REST Resource: customers.analysisQueries

리소스: AnalysisQuery

Ads Data Hub 내에서 실행할 수 있는 분석 쿼리를 정의합니다.

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/analysisqueries/abcd1234'). 리소스 ID는 서버에서 생성됩니다.
title

string

단일 Ads Data Hub 고객 및 검색어 유형 내에서 고유한 쿼리 제목입니다.
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' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z".
updateEmail

string

쿼리를 마지막으로 업데이트한 사용자의 이메일 주소입니다.
createTime

string (Timestamp format)

쿼리가 생성된 시간입니다.

RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z".
createEmail

string

쿼리를 생성한 사용자의 이메일 주소입니다.
queryShare[]

object (QueryShare)

소유한 Ads Data Hub 고객 이외에 쿼리가 공유될 수 있는 방법을 나타냅니다.
통합 필드 filtered_row. 행 병합에 대한 안내입니다. filtered_row은 다음 중 하나여야 합니다.
filteredRowSummary

object (FilteredRowSummary)

개인 정보 보호를 위해 삭제된 행을 병합된 단일 행으로 결합하는 방법을 정의합니다. 병합된 행이 개인 정보 보호 요구사항을 충족하면 병합된 행이 최종 출력에 포함됩니다.
generateFilteredRowSummaryAutomatically

boolean

true인 경우 필터링된 행 요약이 자동으로 생성됩니다.

병합 사양

분석 쿼리 결과 스키마의 안내를 병합합니다.

JSON 표현 
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
필드
columns

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

각 열에 이름을 지정하는 방법에 대한 안내입니다. 누락된 열은 BeyondCorp_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

 제공된 분석 쿼리에 대한 정적 유효성 검사를 수행합니다.