La nuova API Search Ads 360 Reporting è ora disponibile. Unisciti al gruppo Google
searchads-api-announcements per non perderti i prossimi miglioramenti e release.
Riferimento grammaticale delle query
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La tabella riportata di seguito contiene un riferimento completo alla grammatica
del linguaggio di query di Search Ads 360.
Riferimento grammaticale |
Query |
Clausola SELECT |
SELECT FIELD_NAME (, FIELD_NAME)* |
Clausola FROM |
FROM RESOURCE_NAME |
Clausola WHERE |
WHERE CONDITION (AND CONDITION)* |
Clausola ORDER BY |
ORDER BY ORDERING (, ORDERING)* |
Clausola LIMIT |
LIMIT POSITIVE_INTEGER |
Clausola PARAMETERS |
PARAMETERS LITERAL = VALUE (, LITERAL = VALUE)* |
|
Nome campo |
[a-z] ([a-zA-Z0-9._])* |
Nome risorsa |
[a-z] ([a-zA-Z_])* |
Condizione |
FIELD_NAME OPERATOR VALUE |
Ordine |
FIELD_NAME (ASC | DESC)? |
Operatore |
= | != | > | >= | < | <= | IN | NOT IN | LIKE | NOT LIKE | CONTAINS ANY | CONTAINS ALL | CONTAINS NONE | IS NULL | IS NOT NULL | DURING | BETWEEN | REGEXP_MATCH | NOT REGEXP_MATCH |
Funzione |
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 |
Valore |
LITERAL | LITERAL_LIST | NUMBER | NUMBER_LIST | STRING | STRING_LIST | FUNCTION |
Intero positivo |
[1-9] ([0-9])* |
Numero |
-? [0-9]+ (. [0-9] [0-9]*)? |
Stringa |
(' Char* ') | (" Char* ") |
Valore letterale |
[a-zA-Z0-9_]* |
Elenco stringhe |
( STRING (, STRING)* ) |
Elenco di valori letterali |
( LITERAL (, LITERAL)* ) |
Elenco numeri |
( NUMBER (, NUMBER)* ) |
Chiave:
?
indica un elemento facoltativo.
*
indica zero o più
+
indica uno o più.
(xxxxxx)
indica un raggruppamento.
[a-z0-9]
indica un intervallo di caratteri.
Char
indica un carattere qualsiasi.
|
sta per "o".
- L'operatore
REGEXP_MATCH
utilizza la sintassi RE2.
Per trovare una corrispondenza con un valore letterale [
, ]
, %
o _
utilizzando l'operatore LIKE
, racchiudi il carattere tra parentesi quadre. Ad esempio, la seguente condizione corrisponde a tutti i valori campaign.name
che iniziano con [Earth_to_Mars]
:
WHERE campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[[["\u003cp\u003eThis document provides a comprehensive grammar reference for the Search Ads 360 Query Language.\u003c/p\u003e\n"],["\u003cp\u003eThe language allows users to query data using a structured syntax including clauses like \u003ccode\u003eSELECT\u003c/code\u003e, \u003ccode\u003eFROM\u003c/code\u003e, \u003ccode\u003eWHERE\u003c/code\u003e, \u003ccode\u003eORDER BY\u003c/code\u003e, \u003ccode\u003eLIMIT\u003c/code\u003e, and \u003ccode\u003ePARAMETERS\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eVarious data types like numbers, strings, and lists are supported within the query structure for filtering and data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eSpecific operators and functions enable detailed data manipulation, such as date ranges (\u003ccode\u003eLAST_30_DAYS\u003c/code\u003e) and pattern matching (\u003ccode\u003eREGEXP_MATCH\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe provided table details the syntax and components of the query language, along with explanations of special characters and usage examples.\u003c/p\u003e\n"]]],["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"],null,[]]