Google Ads 쿼리 언어 문법

동영상: 쿼리 유효성 검사

다음은 Google Ads 쿼리 언어 문법 참조 (정규 표현식 표기법)입니다.

Query            -> SelectClause FromClause WhereClause? OrderByClause?
                    LimitClause? ParametersClause?
SelectClause     -> SELECT FieldName (, FieldName)*
FromClause       -> FROM ResourceName
WhereClause      -> WHERE Condition (AND Condition)*
OrderByClause    -> ORDER BY Ordering (, Ordering)*
LimitClause      -> LIMIT PositiveInteger
ParametersClause -> PARAMETERS Literal = Value (, Literal = Value)*

Condition        -> FieldName Operator Value
Operator         -> = | != | > | >= | < | <= | IN | NOT IN |
                    LIKE | NOT LIKE | CONTAINS ANY | CONTAINS ALL |
                    CONTAINS NONE | IS NULL | IS NOT NULL | DURING |
                    BETWEEN | REGEXP_MATCH | NOT REGEXP_MATCH
Value            -> Literal | LiteralList | Number | NumberList | String |
                    StringList | Function
Ordering         -> FieldName (ASC | DESC)?

FieldName        -> [a-z] ([a-zA-Z0-9._])*
ResourceName     -> [a-z] ([a-zA-Z_])*

StringList       -> ( String (, String)* )
LiteralList      -> ( Literal (, Literal)* )
NumberList       -> ( Number (, Number)* )

PositiveInteger  -> [1-9] ([0-9])*
Number           -> -? [0-9]+ (. [0-9] [0-9]*)?
String           -> (' Char* ') | (" Char* ")
Literal          -> [a-zA-Z0-9_]*

Function         -> LAST_14_DAYS | LAST_30_DAYS | LAST_7_DAYS |
                    LAST_BUSINESS_WEEK | LAST_MONTH | LAST_WEEK_MON_SUN |
                    LAST_WEEK_SUN_SAT | THIS_MONTH | THIS_WEEK_MON_TODAY |
                    THIS_WEEK_SUN_TODAY | TODAY | YESTERDAY

?는 선택적 요소를 나타냅니다.
*는 0 이상을 의미합니다. +는 하나 이상의
을 의미합니다. (xxxxxx)는 그룹화를 나타냅니다.
[a-z0-9]는 문자 범위를 나타냄
| 는 '또는'을 의미합니다.

규칙 및 제한사항

  • REGEXP_MATCH 연산자는 RE2를 사용합니다. 구문을 참고하세요.

  • LIKE 연산자를 사용하여 리터럴 [, ], % 또는 _를 일치시키려면 서라운드합니다. 대괄호 안에 포함된 문자입니다. 예를 들어 다음 조건은 [Earth_to_Mars]로 시작하는 모든 campaign.name 값:

    campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'
    
  • LIKE 연산자는 배열이 아닌 문자열 필드에서만 사용할 수 있습니다.