GoogleAdsService
ist der einheitliche Dienst für das Abrufen und Berichterstellung in der Google Ads API. Der Dienst verfügt über Methoden, die:
- Bestimmte Attribute von Objekten abrufen
- Leistungsmesswerte für Objekte basierend auf einem Zeitraum abrufen
- Objekte anhand ihrer Attribute anordnen.
- Verwenden Sie Bedingungen, um anzugeben, welche Objekte in der Antwort zurückgegeben werden sollen.
- Begrenzen Sie die Anzahl der zurückgegebenen Objekte.
Der GoogleAdsService
kann Ergebnisse auf zwei Arten zurückgeben:
GoogleAdsService.SearchStream
gibt alle Zeilen in einer einzelnen Streamingantwort zurück,was bei großen Ergebnismengen (mehr als 10.000 Zeilen) effizienter ist. Dies kann sinnvoller sein, wenn Ihre Batchanwendung so viele Daten wie möglich herunterladen möchte.GoogleAdsService.Search
unterteilt große Antworten in überschaubare Ergebnisseiten. Dies könnte sinnvoller sein, wenn in Ihrer interaktiven Anwendung immer nur eine Seite mit Ergebnissen angezeigt wird.
Weitere Informationen zu Paging und Streaming
Anfrage stellen
Für die Suchmethode ist ein SearchGoogleAdsRequest
erforderlich, der aus den folgenden Attributen besteht:
- Ein
customer_id
- Ein
query
in Google Ads Query Language, das angibt, welche Ressource abgefragt werden soll, welche Attribute, Segmente und Messwerte abgerufen werden sollen und mit welchen Bedingungen die zurückgegebenen Objekte eingeschränkt werden. - (Nur
GoogleAdsService.Search
) Mitpage_size
wird angegeben, wie viele Objekte in einer einzelnen Antwort zurückgegeben werden, wenn Paging verwendet wird. - (Nur
GoogleAdsService.Search
) Ein optionalespage_token
, um den nächsten Batch von Ergebnissen abzurufen, wenn Paging verwendet wird.
Weitere Informationen zu Google Ads Query Language finden Sie im Leitfaden zur Google Ads Query Language.
Antwort verarbeiten
GoogleAdsService
gibt eine Liste von GoogleAdsRow
-Objekten zurück.
Jeder GoogleAdsRow
stellt ein von einer Abfrage zurückgegebenes Objekt dar und besteht aus einer Reihe von Attributen, die anhand der in der SELECT
-Klausel angeforderten Felder ausgefüllt werden. Attribute, die nicht in der SELECT
-Klausel enthalten sind, werden für die GoogleAdsRow
-Objekte in der Antwort nicht ausgefüllt.
Beispiel: Obwohl ein ad_group_criterion
ein status
-Attribut hat, wird das Feld status
des ad_group_criterion
-Attributs der Zeile in einer Antwort auf eine Abfrage, bei der ad_group_criterion.status
in der SELECT
-Klausel nicht enthalten ist, nicht ausgefüllt. Ebenso wird das Attribut campaign
der Zeile nicht ausgefüllt, wenn die SELECT
-Klausel keine Felder aus der Ressource campaign
enthält.
Jede GoogleAdsRow
kann unterschiedliche Attribute und Messwerte aus einer anderen Zeile in demselben Ergebnissatz haben. Daher sollten die Zeilen als Objekte und nicht als feste Zeilen einer Tabelle betrachtet werden.
UNBEKANNTE enum-Typen
Ressourcen, die mit dem Typ UNKNOWN
zurückgegeben werden, werden in dieser API-Version nicht vollständig unterstützt. Diese Ressourcen können auch über andere Benutzeroberflächen wie die Google Ads-Benutzeroberfläche erstellt worden sein. Sie können Messwerte auswählen, wenn eine Ressource den Typ UNKNOWN
hat. Sie können die Ressource jedoch nicht über die API ändern. Ein Beispiel hierfür wäre eine neue Kampagne oder Anzeige, die in der Benutzeroberfläche eingeführt wird, aber in der abgefragten API-Version nicht unterstützt wird.
Beachten Sie dabei Folgendes:
- Eine Ressource mit dem Typ
UNKNOWN
kann später unterstützt werden oder unbegrenztUNKNOWN
bleiben. - Neue Objekte vom Typ
UNKNOWN
können jederzeit angezeigt werden. Diese Objekte sind abwärtskompatibel, da der ENUM-Wert bereits verfügbar ist. Mit dieser Änderung werden Ressourcen eingeführt, sobald sie verfügbar sind, damit Sie einen genauen Überblick über Ihr Konto erhalten. Die RessourceUNKNOWN
kann aufgrund neuer Aktivitäten in Ihrem Konto über andere Benutzeroberflächen oder aufgrund nicht mehr unterstützter Ressourcen angezeigt werden. UNKNOWN
-Ressourcen können detaillierte Messwerte angehängt werden, die abgefragt werden können.UNKNOWN
-Ressourcen sind in der Regel vollständig auf der Google Ads-Benutzeroberfläche sichtbar.UNKNOWN
Ressourcen können im Allgemeinen nicht geändert werden.
Segmentierung
Die Antwort würde eine GoogleAdsRow
für jede Kombination aus Folgendem enthalten:
- Instanz der in der
FROM
-Klausel angegebenen Hauptressource - Wert jedes ausgewählten
segment
-Felds
Beispiel: Die Antwort auf eine Abfrage, bei der FROM campaign
ausgewählt wird und bei der segments.ad_network_type
und segments.date
in der SELECT
-Klausel enthalten sind, enthält eine Zeile für jede Kombination aus folgenden Elementen:
campaign
segments.ad_network_type
segments.date
Die Ergebnisse werden implizit nach jeder Instanz der Hauptressource segmentiert, nicht nach den Werten der einzelnen ausgewählten Felder. Beispiel:
SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS
führt zu einer Zeile pro Kampagne und nicht zu einer Zeile pro eindeutigem Wert im Feld campaign.status
.