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 von
GoogleAdsRow
-Instanzen, wobei jedeGoogleAdsRow
eine Ressource darstellt. Wenn Attribute oder Messwerte angefordert werden, enthält die Zeile auch diese Felder. Wenn Segmente angefordert werden, enthält die Antwort auch eine zusätzliche Zeile für jedes Segment-Ressourcen-Tupel. - Metadaten zu verfügbaren Feldern und Ressourcen in
GoogleAdsFieldService
Dieser Dienst bietet einen Katalog abfragbarer Felder mit Details zu ihrer Kompatibilität und ihrem Typ.
Das Ergebnis einer
GoogleAdsFieldService
-Abfrage ist eine Liste vonGoogleAdsField
-Instanzen, wobei jedeGoogleAdsField
Details zum angeforderten Feld enthält.
Attribute einer Ressource abfragen
Unten sehen Sie eine einfache Abfrage für Attribute der Kampagnenressource. Sie veranschaulicht, wie die ID, der Name und der Status der Kampagne zurückgegeben werden:
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 darstellen, das mit den ausgewählten Feldern (einschließlich der jeweiligen resource_name
der Kampagne) ausgefüllt ist.
Informationen dazu, welche anderen Felder für Kampagnenabfragen verfügbar sind, finden Sie in der Referenzdokumentation zu Campaign
.
Messwerte abfragen
Neben ausgewählten Attributen für eine bestimmte Ressource können Sie auch verwandte Messwerte abfragen:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
Diese Abfrage filtert nur nach Kampagnen mit dem Status PAUSED
und mehr als 1.000 Impressionen. Die Sortierung erfolgt nach Kampagnen-ID. Für jede resultierende GoogleAdsRow
wird das Feld metrics
mit den ausgewählten Messwerten gefüllt.
Eine Liste der abfragbaren Messwerte finden Sie in der Dokumentation zu Metrics
.
Segmente abfragen
Neben ausgewählten Attributen für eine bestimmte Ressource können Sie auch verwandte Segmente abfragen:
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 bei der Abfrage von Messwerten wird mit dieser Abfrage nur nach Kampagnen gefiltert, die den Status PAUSED
haben und mehr als 1.000 Impressionen haben. Die Daten werden bei dieser Abfrage jedoch nach Datum segmentiert. Daraus ergibt sich, dass jede resultierende GoogleAdsRow
ein Tupel einer Kampagne und das Datum Segment
darstellt. Beachten Sie, dass die Segmentierung die ausgewählten Messwerte aufteilt und nach jedem Segment in der SELECT-Klausel gruppiert.
Eine Liste der abfragbaren Segmente finden Sie in der Dokumentation zu Segments
.
Attribute einer zugehörigen Ressource abfragen
In einer Abfrage für eine bestimmte Ressource können Sie möglicherweise einen Join mit anderen verwandten Ressourcen durchführen, sofern verfügbar. Diese verwandten Ressourcen werden als „zugeordnete Ressourcen“ bezeichnet. Sie können einen Join mit zugeordneten Ressourcen vornehmen, indem Sie ein Attribut in der Abfrage auswählen.
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 aus jeder ausgewählten Kampagne abgerufen. Jede resultierende GoogleAdsRow
repräsentiert ein campaign
-Objekt, das mit den ausgewählten Kampagnenattributen sowie dem ausgewählten Gebotsstrategieattribut bidding_strategy.name
ausgefüllt ist.
Welche zugeordneten Ressourcen für Kampagnenabfragen verfügbar sind, erfahren Sie in der Referenzdokumentation zu Campaign
.
Änderung basierend auf Abfrageergebnissen
Wenn Sie eine bestimmte Ressource abfragen, können Sie die zurückgegebenen Ergebnisse sofort als Objekte annehmen, ändern und an die mutate-Methode im Dienst der jeweiligen Ressource zurücksenden. Beispiel für einen Workflow:
- Führen Sie eine Abfrage für alle Kampagnen aus, die derzeit
PAUSED
sind und mehr als 1.000 Impressionen haben. - Rufen Sie das
Campaign
-Objekt aus dem Feldcampaign
jederGoogleAdsRow
in der Antwort ab. - Ändern Sie den Status der einzelnen Kampagnen von
PAUSED
inENABLED
. - Rufen Sie
CampaignService.MutateCampaigns
mit den geänderten Kampagnen auf, um sie zu aktualisieren.
Feldmetadaten
An GoogleAdsFieldService
gesendete Abfragen dienen zum Abrufen von Feldmetadaten.
Anhand dieser Informationen lässt sich nachvollziehen, wie die Felder in einer Abfrage zusammen verwendet werden können. Da Daten über die API verfügbar sind und die erforderlichen Metadaten zum Validieren oder Erstellen einer Abfrage bereitgestellt werden, können Entwickler dies programmatisch tun. Hier ist eine typische Metadatenabfrage:
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 eine Ressource (z. B. customer
oder campaign
) oder durch ein Feld (z. B. campaign.id
, metrics.impressions
oder ad_group.id
) ersetzen.
Eine Liste der abfragbaren Felder finden Sie in der Dokumentation zu GoogleAdsField
.
Codebeispiele
Die Clientbibliotheken enthalten Beispiele für die Verwendung der Google Ads Query Language in GoogleAdsService
. Der Ordner grundlegende Vorgänge enthält Beispiele wie GetCampaigns
, GetKeywords
und SearchForGoogleAdsFields
.
Der Ordner reporting enthält ein GetKeywordStats
-Beispiel.