Struktura zapytania

Zapytania o pola danych i segmentów można wysyłać do reports.search . Aby utworzyć zapytanie w języku zapytań w Merchant Center, musisz najpierw muszą być zgodne z gramatyką języka. Zapytanie składa się z kilku klauzul:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT

Klauzule używają nazw pól, nazw tabel, operatorów, warunków i orderings, które ułatwiają wybranie odpowiednich danych. Po połączeniu w jeden żądanie można przesłać za pomocą interfejsu Google Content API for Shopping. Przyjrzyjmy się temu, .

Klauzule

WYBIERZ

Klauzula SELECT określa zbiór pól do pobrania w żądaniu. SELECT pobiera rozdzielaną przecinkami listę pól i danych segmentu, zwracając wartości w odpowiedzi. W zapytaniu wymagana jest klauzula SELECT.

Oto przykładowe zapytanie, które wybiera dane o kliknięciach z danej tabeli:

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

W jednym żądaniu możesz też wysyłać zapytania o różne typy pól:

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

  • Pola segmentu

    • segments.date
    • segments.program

  • Dane

    • metrics.impressions
    • metrics.clicks

Niektóre pola są niedozwolone w klauzuli SELECT z tych powodów: ograniczenie:

  • Zapytanie o pola segmentu, które nie zawierają co najmniej jednego pola danych.

Informacje dotyczące powyższego stanu można znaleźć w naszych dokumentach referencyjnych.

FROM

Klauzula FROM określa tabelę, z której mają zostać pobrane dane w żądaniu. tabela w klauzuli FROM określa, których pól mogą używać pozostałe dla danego zapytania. W funkcji klauzulę FROM. Obecnie obsługiwana jest tylko tabela MerchantPerformanceView Klauzula FROM jest wymagana w zapytaniu do metody search na stronie reports.

WHERE

Klauzula WHERE określa warunki, które należy stosować podczas filtrowania danych: użytkownika. Jeśli używasz klauzuli WHERE, możesz określić co najmniej 1 warunek za pomocą AND. Każdy warunek powinien być zgodny ze wzorem field_name Operator value W WHERE można używać dowolnych pól segmentów , ale w klauzuli SELECT trzeba określić pola wskaźników, używane w klauzuli WHERE. W zapytaniu wymagana jest klauzula WHERE, bo zawsze musisz podać zakres dat, dane o skuteczności reklam.

Poniżej znajdziesz przykład użycia funkcji WHERE do zwrócenia danych z określonego momentu okres:

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

Możesz łączyć kilka warunków, aby filtrować dane. Ten przykład zwróci liczba kliknięć na ofertę w programie SHOPPING_ADS, w którym kliknięcia > 100 w danym okresie 30 dni.

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’;

W poniższym zapytaniu zobaczysz, że wybrano pole segments.date. Niezależnie od tego, czy wybierzesz segments.date, ograniczony zakres dat w W celu pobrania danych o wydajności zawsze należy podać klauzulę WHERE.

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

Podczas filtrowania warto pamiętać, że operator uwzględnia wielkość liter. umysł.

Pełną listę operatorów znajdziesz w gramatyki języka,

ORDER BY

Klauzula ORDER BY określa kolejność, w jakiej wyniki mają zostać wyświetlone. . Pozwala to uporządkować dane w kolejności rosnącej lub malejącej. na podstawie nazwy pola. Każde zamówienie jest określane za pomocą znaku field_name, po którym następuje znak ASC lub DESC. Jeśli nie podasz ani ASC, ani DESC, kolejność będzie domyślnie ustawiona do ASC. W parametrze SELECT można użyć tylko pól określonych w klauzuli SELECT Klauzula ORDER BY. Klauzula ORDER BY jest opcjonalna w zapytaniu.

To zapytanie porządkuje zwrócone wiersze według liczby kliknięć od największej do najniższa:

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

W klauzuli ORDER BY możesz określić większą liczbę pól, rozdzielając je przecinkami z listy. Kolejność wyświetlania reklam będzie wykonywana w takiej samej kolejności jak w zapytaniu. Na przykład w tym zapytaniu wyniki zostaną posortowane rosnąco według offer_id, a następnie w kolejności malejącej według liczby wyświetleń, a potem w kolejności malejącej w kolejności malejącej według liczby kliknięć:

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

Klauzula LIMIT umożliwia określenie liczby wyników do zwrócenia. Przydaje się to, jeśli interesuje Cię tylko podsumowanie.

Na przykład LIMIT można użyć do ograniczenia łącznej liczby wyników dla zapytania to zapytanie:

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
Wstecz
Gramatyka zapytania
Dalej
Zakresy dat