Struttura delle query

Le query relative ai campi delle metriche e dei segmenti possono essere inviate al reports.search . Per creare una query nel linguaggio di query di Merchant Center, devi prima scrivere il utilizzando la grammatica del linguaggio. Una query è composta da una serie di clausole:

• SELECT
• FROM
• WHERE
• ORDER BY
• LIMIT

Le clausole utilizzano nomi campo, nomi di tabella, operatori, condizioni e ordering per aiutarti a selezionare i dati desiderati. Una volta combinati in un'unica una richiesta, può essere effettuata una richiesta utilizzando la Google Content API for Shopping. Vediamo in che modo ogni una clausola.

Clausole

SELEZIONA

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

Ecco un esempio di query 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’

Puoi anche eseguire query su diversi tipi di campi in una singola richiesta:

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

• Campi segmento

  • segments.date
  • segments.program

• Metriche

  • metrics.impressions
  • metrics.clicks

Alcuni campi non sono consentiti nella clausola SELECT a causa di quanto segue restrizione:

• Esecuzione di query sui campi dei segmenti senza almeno un campo metrica.

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

FROM

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

WHERE

La clausola WHERE specifica le condizioni da applicare quando si filtrano i dati per l'elemento richiesta. Quando utilizzi la clausola WHERE, è possibile specificare una o più condizioni utilizzando AND per separarli. Ogni condizione deve seguire il pattern field_name Operator value. È possibile utilizzare qualsiasi campo dei segmenti in WHERE ma i campi delle metriche devono essere specificati nella clausola SELECT per usato nella clausola WHERE. La clausola WHERE è obbligatoria in una query, perché devi sempre specificare l'intervallo di date in cui vuoi che vengono restituiti i dati sul rendimento.

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

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 restituisce Il numero di clic per offerta per il programma SHOPPING_ADS in cui i clic > 100 nel periodo di 30 giorni.

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 è stato selezionato segments.date. A prescindere dalla selezione di segments.date, un intervallo di date limitato nel Per recuperare i dati sul rendimento, è sempre necessario fornire la clausola WHERE.

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

Quando filtri, è importante tenere presente la sensibilità alle maiuscole dell'operatore mente.

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

ORDER BY

La clausola ORDER BY specifica l'ordine in cui devono essere visualizzati i risultati restituito. In questo modo puoi disporre i dati in ordine crescente o decrescente. in base al nome di un campo. Ogni ordinamento è specificato come field_name seguito da ASC o DESC. Se non vengono specificati né ASC né DESC, i valori predefiniti dell'ordine a ASC. Solo i campi specificati nella clausola SELECT possono essere utilizzati nel 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 una virgola dall'elenco di lettura. L'ordinamento verrà applicato 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 in base al numero di impressioni e poi in in ordine decrescente in base al 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

LIMIT

La clausola LIMIT consente di specificare il numero di risultati da restituire. È utile se sei interessato solo a un riepilogo.

Ad esempio, LIMIT può essere utilizzato per limitare il numero totale di risultati per 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