Diese Seite wurde von der Cloud Translation API übersetzt.

Abfragestruktur

Abfragen für Messwert- und Segmentfelder können an die Methode reports.search gesendet werden. Um eine Abfrage in der Merchant Center Query Language zu erstellen, müssen Sie sie zuerst mithilfe der Sprachgrammatik verfassen, die aus mehreren Klauseln besteht:

SELECT
FROM
WHERE
ORDER BY
LIMIT

In Klauseln werden Feldnamen, Tabellennamen, Operatoren, Bedingungen und Reihenfolgen verwendet, um die gewünschten Daten auszuwählen. Wenn diese zu einer einzigen Abfrage zusammengefasst werden, kann eine Anfrage über die Google Content API for Shopping gestellt werden. Schauen wir uns an, wie jede Klausel verwendet werden kann.

klauseln

SELECT

Die SELECT-Klausel gibt eine Reihe von Feldern an, die in der Anfrage abgerufen werden sollen. SELECT verwendet eine durch Kommas getrennte Liste von Segmentfeldern und Messwerten und gibt die Werte in der Antwort zurück. Die SELECT-Klausel ist in einer Abfrage erforderlich.

Hier sehen Sie eine Beispielabfrage, mit der Klickmesswerte aus einer bestimmten Tabelle ausgewählt werden:

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

Sie können auch verschiedene Feldtypen in einer einzelnen Anfrage abfragen:

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

Segmentfelder
- segments.date
- segments.program
Messwerte
- metrics.impressions
- metrics.clicks

Einige Felder sind in der SELECT-Klausel aufgrund der folgenden Einschränkung nicht zulässig:

Segmentfelder ohne mindestens ein Messwertfeld abfragen

Informationen zur oben genannten Bedingung finden Sie in unseren Referenzdokumenten.

VOM

Die FROM-Klausel gibt die Tabelle an, aus der Daten in der Anfrage abgerufen werden sollen. Die Tabelle in der FROM-Klausel definiert, welche Felder von allen anderen Klauseln für die angegebene Abfrage verwendet werden können. In der FROM-Klausel kann nur eine einzelne Tabelle angegeben werden. Derzeit wird nur die Tabelle „MerchantPerformanceView“ unterstützt. Die FROM-Klausel ist in einer Abfrage der Methode search für den Dienst reports erforderlich.

DABEI GILT:

Die WHERE-Klausel gibt Bedingungen an, die beim Filtern von Daten für die Anfrage angewendet werden. Wenn Sie die WHERE-Klausel verwenden, können eine oder mehrere Bedingungen angegeben werden, indem Sie AND verwenden, um sie zu trennen. Jede Bedingung sollte dem Muster field_name Operator value folgen. In der WHERE-Klausel kann jedes Segmentfeld verwendet werden. Messwertfelder müssen jedoch in der SELECT-Klausel angegeben werden, um in der WHERE-Klausel verwendet zu werden. Die WHERE-Klausel ist in einer Abfrage erforderlich, da Sie immer den Zeitraum angeben müssen, für den die Leistungsdaten zurückgegeben werden sollen.

Im folgenden Beispiel wird WHERE verwendet, um Messwerte aus einem bestimmten Zeitraum zurückzugeben:

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

Sie können mehrere Bedingungen kombinieren, um die Daten zu filtern. In diesem Beispiel wird die Anzahl der Klicks pro Angebot für das SHOPPING_ADS-Programm zurückgegeben, bei denen die Anzahl der Klicks innerhalb des angegebenen Zeitraums von 30 Tagen größer als 100 ist.

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

In der folgenden Abfrage sehen Sie, dass segments.date ausgewählt wurde. Unabhängig davon, ob Sie segments.date auswählen, muss in der WHERE-Klausel immer ein endlicher Zeitraum angegeben werden, um Leistungsdaten abzurufen.

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

Beim Filtern ist es wichtig, die Groß- und Kleinschreibung des Operators zu beachten.

Eine vollständige Liste der Operatoren finden Sie in der Sprachgrammatik.

ORDER BY

Die ORDER BY-Klausel gibt die Reihenfolge an, in der die Ergebnisse zurückgegeben werden sollen. So können Sie die Daten basierend auf einem Feldnamen in aufsteigender oder absteigender Reihenfolge anordnen. Jede Sortierung wird als field_name gefolgt von ASC oder DESC angegeben. Wenn weder ASC noch DESC angegeben ist, wird standardmäßig ASC verwendet. Nur in der SELECT-Klausel angegebene Felder können in der ORDER BY-Klausel verwendet werden. Die ORDER BY-Klausel ist in einer Abfrage optional.

Die folgende Abfrage sortiert die zurückgegebenen Zeilen nach der Anzahl der Klicks vom höchsten zum niedrigsten Wert:

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

Mithilfe einer durch Kommas getrennten Liste können Sie mehrere Felder in der ORDER BY-Klausel angeben. Die Sortierung erfolgt in der gleichen Reihenfolge wie in der Abfrage angegeben. In dieser Abfrage werden die Ergebnisse beispielsweise in aufsteigender Reihenfolge nach offer_id, dann in absteigender Reihenfolge nach der Anzahl der Impressionen und dann in absteigender Reihenfolge nach Anzahl der Klicks sortiert:

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

Mit der LIMIT-Klausel können Sie die Anzahl der Ergebnisse angeben, die zurückgegeben werden sollen. Dies ist nützlich, wenn Sie nur an einer Zusammenfassung interessiert sind.

Mit LIMIT kann beispielsweise die Gesamtzahl der Ergebnisse für die folgende Abfrage eingeschränkt werden:

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