Objekte werden abgerufen

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) Mit page_size wird angegeben, wie viele Objekte in einer einzelnen Antwort zurückgegeben werden, wenn Paging verwendet wird.
  • (Nur GoogleAdsService.Search) Ein optionales page_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 unbegrenzt UNKNOWN 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 Ressource UNKNOWN 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.