Diese Seite wurde von der Cloud Translation API übersetzt.

Google Ads-Abfragesprache

Mit der Google Ads Query Language kann die Google Ads API nach

Ressourcen und die zugehörigen Attribute, Segmente und Messwerte mit

GoogleAdsService Suche oder SearchStream

Das Ergebnis einer GoogleAdsService-Abfrage ist eine Liste GoogleAdsRow Instanzen mit jeweils GoogleAdsRow für eine Ressource. Wenn Attribute oder Messwerte angefordert werden, enthält auch diese Felder. Wenn Segmente angefordert werden, wird außerdem für jedes Segment-Ressourcen-Tupel eine zusätzliche Zeile angezeigt.

Metadaten zu verfügbaren Feldern und Ressourcen in

GoogleAdsFieldService

Dieser Dienst bietet einen Katalog abfragbarer Felder mit Details zu deren Kompatibilität und Typ.

Das Ergebnis einer GoogleAdsFieldService-Abfrage ist eine Liste von GoogleAdsField Instanzen mit jeder GoogleAdsField mit Details zum angeforderten Feld.

Attribute einer Ressource abfragen

Unten sehen Sie eine einfache Abfrage für Attribute der Kampagnenressource. Sie veranschaulicht, , um die ID, den Namen und den Status der Kampagne zurückzugeben:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

Diese Abfrage sortiert nach Kampagnen-ID. Jede resultierende GoogleAdsRow würde Ein campaign-Objekt, das mit den ausgewählten Feldern (einschließlich der angegebenen resource_name der Kampagne).

Welche anderen Felder für Kampagnenabfragen verfügbar sind, erfahren Sie im Referenzdokumentation zu Campaign

Messwerte abfragen

Neben ausgewählten Attributen für eine Ressource können Sie auch nach Zugehörige Messwerte:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

Mit dieser Abfrage wird nur nach Kampagnen mit dem Status PAUSED und die mehr als 1.000 Impressionen erzielt haben, während sie nach Kampagnen-ID sortiert werden. Jedes Der resultierende GoogleAdsRow hätte das Feld metrics mit dem Wert ausgewählten Messwerten.

Eine Liste der abfragbaren Messwerte finden Sie in der Metrics Dokumentation.

Segmente abfragen

Neben ausgewählten Attributen für eine Ressource können Sie auch nach Zugehörige Segmente:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

Ähnlich wie die Abfrage von Messwerten filtert diese Abfrage nur nach Kampagnen, den Status PAUSED haben und mehr als 1.000 Impressionen erzielt haben Allerdings die Daten nach Datum segmentiert. Daraus ergeben sich GoogleAdsRow, die ein Tupel einer Kampagne und das Datum Segment darstellt. Es ist Bei der Segmentierung werden die ausgewählten Messwerte SELECT-Anweisung verwenden.

Eine Liste der abfragbaren Segmente finden Sie im Segments. Dokumentation.

Attribute einer zugehörigen Ressource abfragen

In einer Abfrage für eine bestimmte Ressource können Sie sie möglicherweise mit anderen verwandten Ressourcen, falls verfügbar. Diese verwandten Ressourcen werden als „zugeordnete Ressourcen“. Sie können einen Join mit zugeordneten Ressourcen vornehmen, indem Sie ein Attribut in Ihrer Abfrage.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

Mit dieser Abfrage werden nicht nur Kampagnenattribute ausgewählt, sondern auch zugehörige Attribute der einzelnen ausgewählten Kampagnen. Jede resultierende GoogleAdsRow stellt Ein campaign-Objekt, das mit den ausgewählten Kampagnenattributen sowie das ausgewählte Gebotsstrategieattribut bidding_strategy.name.

Um herauszufinden, welche zugeordneten Ressourcen für Kampagnenabfragen verfügbar sind, finden Sie in der Referenzdokumentation zu Campaign.

Änderung basierend auf Abfrageergebnissen

Beim Abfragen einer bestimmten Ressource können Sie die zurückgegebenen Daten Ergebnisse als Objekte, ändern sie und senden sie zurück an die mutate-Methode, Dienst der Ressource. Beispiel für einen Workflow:

Abfrage für alle Kampagnen ausführen, die den Status „PAUSED“ haben und Impressionen größer als 1.000.
Rufen Sie das Campaign-Objekt aus dem Feld campaign jeder GoogleAdsRow in auf die Antwort.
Ändern Sie den Status der einzelnen Kampagnen von PAUSED in ENABLED.
CampaignService.MutateCampaigns anrufen mit den geänderten Kampagnen, um sie zu aktualisieren.

Feldmetadaten

An GoogleAdsFieldService gesendete Abfragen dienen zum Abrufen von Feldmetadaten. Anhand dieser Informationen lässt sich nachvollziehen, wie die Felder zusammen verwendet werden können. in einer Abfrage. Da Daten über die API verfügbar sind und die erforderlichen Metadaten, die zum Validieren oder Erstellen einer Abfrage erforderlich sind, können Entwickler also programmatisch. Hier ist ein typische Abfrage von Metadaten:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

Sie können <INSERT_RESOURCE_OR_FIELD> in dieser Abfrage entweder durch einen Ressource (z. B. customer oder campaign) oder Feld (z. B. campaign.id, metrics.impressions oder ad_group.id).

Eine Liste der abfragbaren Felder finden Sie in der GoogleAdsField Dokumentation.

Codebeispiele

Die Clientbibliotheken enthalten Beispiele für die Verwendung der Google Ads Query Language auf GoogleAdsService. Der Ordner basic operations enthält Beispiele wie GetCampaigns, GetKeywords und SearchForGoogleAdsFields. Der Ordner reporting enthält ein GetKeywordStats-Beispiel.

Weiter

Abfragegrammatik