Struttura della query

Le query per i campi delle metriche e dei segmenti possono essere inviate al metodo reports.search. Per creare una query nel linguaggio di query di Merchant Center, devi prima comporre la query utilizzando la grammatica della lingua. Una query è costituita da una serie di clausole:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT

Le clausole utilizzano nomi di campo, nomi di tabelle, operatori, condizioni e ordini per aiutarti a selezionare i dati desiderati. Una volta combinate in una singola query, è possibile effettuare una richiesta utilizzando la Google Content API for Shopping. Vediamo come utilizzare ciascuna clausola.

Clausole

SELECT

La clausola SELECT specifica un insieme di campi da recuperare nella richiesta. SELECT prende un elenco di campi e metriche del segmento separati da virgole, restituendo i valori nella risposta. La clausola SELECT è obbligatoria in una query.

Di seguito è riportata una query di esempio che seleziona le metriche sui clic da una determinata tabella:

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

In una singola richiesta puoi anche eseguire query su tipi di campi diversi:

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

  • Campi del segmento

    • segments.date
    • segments.program

  • Metriche

    • metrics.impressions
    • metrics.clicks

Alcuni campi non sono consentiti nella clausola SELECT a causa della seguente limitazione:

  • Esecuzione di query sui campi del segmento senza almeno un campo della metrica.

Le informazioni relative alla condizione sopra indicata sono disponibili nei nostri documenti di riferimento.

FROM

La clausola FROM specifica la tabella da cui recuperare i dati nella richiesta. La tabella nella clausola FROM definisce quali campi possono essere utilizzati da tutte le altre clausole per la query specificata. È possibile specificare una sola tabella nella clausola FROM. Al momento è supportata solo la tabella MerchantPerformanceView. La clausola FROM è obbligatoria in una query al metodo search sul servizio reports.

WHERE

La clausola WHERE specifica le condizioni da applicare quando filtri i dati per la richiesta. Quando utilizzi la clausola WHERE, è possibile specificare una o più condizioni utilizzando AND per separarle. Ogni condizione deve seguire il pattern field_name Operator value. Qualsiasi campo relativo ai segmenti può essere utilizzato nella clausola WHERE, ma i campi delle metriche devono essere specificati nella clausola SELECT per essere utilizzati nella clausola WHERE. La clausola WHERE è obbligatoria in una query, perché devi sempre specificare l'intervallo di date entro il quale vuoi che vengano restituiti i dati sul rendimento.

Di seguito è riportato un esempio di utilizzo di WHERE per restituire le metriche relative a un determinato periodo di tempo:

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

Puoi combinare più condizioni per filtrare i dati. Questo esempio restituirà il numero di clic per offerta per il programma SHOPPING_ADS in cui i clic sono > 100 nel periodo di 30 giorni specificato.

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’;

Nella query seguente noterai che è stata selezionata l'opzione segments.date. Indipendentemente dalla selezione di segments.date, è sempre necessario fornire un intervallo di date finito nella clausola WHERE per recuperare i dati sul rendimento.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

Quando applichi un filtro, è importante tenere presente la sensibilità alle maiuscole dell'operatore.

Per un elenco completo degli operatori, consulta la grammatica della lingua.

ORDER BY

La clausola ORDER BY specifica l'ordine in cui i risultati devono essere restituiti. Ciò consente di disporre i dati in ordine crescente o decrescente in base al nome di un campo. Ogni ordine è specificato come field_name seguito da ASC o DESC. Se non vengono specificati né ASC né DESC, l'ordine predefinito sarà ASC. Solo i campi specificati nella clausola SELECT possono essere utilizzati nella clausola ORDER BY. La clausola ORDER BY è facoltativa in una query.

La seguente query ordina le righe restituite in base al numero di clic, dal più alto al più basso:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.clicks DESC

Puoi specificare più campi nella clausola ORDER BY utilizzando un elenco separato da virgole. L'ordinamento avverrà nella stessa sequenza specificata nella query. Ad esempio, in questa query, i risultati verranno ordinati in ordine crescente per offer_id, poi in ordine decrescente per numero di impressioni e in ordine decrescente per numero di clic:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMITE

La clausola LIMIT consente di specificare il numero di risultati da restituire. Questo è utile se ti interessa solo un riepilogo.

Ad esempio, LIMIT può essere utilizzato per limitare il numero totale di risultati per la seguente query:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.impressions DESC
LIMIT 50
Indietro
Grammatica delle query
Avanti
Intervalli di date