A nova API Search Ads 360 Reporting já está disponível. Participe do grupo do Google 
searchads-api-announcements para ficar por dentro das próximas melhorias e versões.
  
        
 
     
  
  
  
    
  
  
  
    
      Referência de gramática
    
    
      
    
    
      
      Mantenha tudo organizado com as coleções
    
    
      
      Salve e categorize o conteúdo com base nas suas preferências.
    
  
  
      
    
  
  
  
  
  
    
  
  
    
    
    
  
  
  
  
  
  
  
  
  
  
A tabela abaixo contém uma referência completa da gramática da linguagem de consulta do Search Ads 360.
  
    | Referência de gramática | 
  
    | Consulta | 
        
          | Cláusula SELECT | SELECT FIELD_NAME (, FIELD_NAME)* |  
          | Cláusula FROM | FROM RESOURCE_NAME |  
          | Cláusula WHERE | WHERE CONDITION (AND CONDITION)* |  
          | Cláusula ORDER BY | ORDER BY ORDERING (, ORDERING)* |  
          | Cláusula LIMIT | LIMIT POSITIVE_INTEGER |  
          | Cláusula PARAMETERS | PARAMETERS LITERAL = VALUE (, LITERAL = VALUE)* |  | 
  
    | Nome do campo | [a-z] ([a-zA-Z0-9._])* | 
  
    | Nome do recurso | [a-z] ([a-zA-Z_])* | 
  
    | Condição | FIELD_NAMEOPERATORVALUE | 
  
    | Pedidos | FIELD_NAME (ASC | DESC)? | 
  
    | Operador | = | != | > | >= | < | <= | IN | NOT IN | LIKE | NOT LIKE | CONTAINS ANY |CONTAINS ALL | CONTAINS NONE | IS NULL | IS NOT NULL | DURING | BETWEEN |
 REGEXP_MATCH | NOT REGEXP_MATCH
 | 
  
    | Função | 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
 | 
  
    | Valor | LITERAL | LITERAL_LIST | NUMBER | NUMBER_LIST | STRING | STRING_LIST | FUNCTION | 
  
    | Número inteiro positivo | [1-9] ([0-9])* | 
  
    | Número | -? [0-9]+ (. [0-9] [0-9]*)? | 
  
    | String | (' Char* ') | (" Char* ") | 
  
    | Literal | [a-zA-Z0-9_]* | 
  
    | Lista de strings | ( STRING (, STRING)* ) | 
  
    | Lista literal | ( LITERAL (, LITERAL)* ) | 
  
    | Lista de números | ( NUMBER (, NUMBER)* ) | 
Chave:
- ?indica um elemento opcional.
- *significa zero ou mais
- +significa um ou mais.
- (xxxxxx)indica um agrupamento.
- [a-z0-9]indica um intervalo de caracteres.
- Charindica qualquer caractere.
- |significa "ou".
- O operador REGEXP_MATCHusa a sintaxe RE2.
- Para corresponder a um literal - [,- ],- %ou- _usando o operador- LIKE, coloque o caractere entre colchetes. Por exemplo, a condição a seguir corresponde a todos os valores- campaign.nameque começam com- [Earth_to_Mars]:
 - WHERE campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'
 
 
  
    
    
      
       
    
    
  
  
  Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
  Última atualização 2025-08-29 UTC.
  
  
  
    
      [null,null,["Última atualização 2025-08-29 UTC."],[],["The Search Ads 360 Query Language grammar includes clauses like `SELECT`, `FROM`, `WHERE`, `ORDER BY`, `LIMIT`, and `PARAMETERS`. It defines field, resource, and operator types, allowing queries to select data, specify the source, filter results, order them, and limit the output.  Conditions are built with `FIELD_NAME`, `OPERATOR`, and `VALUE`. Values can be literals, numbers, strings, or lists. The grammar includes operators like `=`, `!=`, `\u003e`, `IN`, `LIKE`, and `REGEXP_MATCH` for comparisons.\n"]]