Objekte werden abgerufen

GoogleAdsService ist der einheitliche Objektabruf- und Berichtsdienst der Google Ads API. Der Dienst hat Methoden, die:

  • Bestimmte Attribute von Objekten abrufen.
  • Leistungsmesswerte für Objekte nach einem bestimmten Zeitraum abrufen
  • Objekte anhand ihrer Attribute sortieren
  • Mit Bedingungen können Sie angeben, welche Objekte in der Antwort zurückgegeben werden sollen.
  • Begrenzen Sie die Anzahl der zurückgegebenen Objekte.

Mit GoogleAdsService können Ergebnisse auf zwei Arten zurückgegeben werden:

  • GoogleAdsService.SearchStream gibt alle Zeilen in einer einzigen Streamingantwort zurück. Das ist bei großen Ergebnismengen (mehr als 10.000 Zeilen) effizienter. Dies ist möglicherweise besser geeignet, wenn mit Ihrer Batchanwendung so viele Daten wie möglich so schnell wie möglich heruntergeladen werden sollen.
  • GoogleAdsService.Search unterteilt große Antworten in überschaubare Ergebnisseiten. Das kann sinnvoller sein, wenn in Ihrer interaktiven Anwendung jeweils eine Seite mit Ergebnissen angezeigt wird.

Weitere Informationen zum Vergleich von Auslagerung und Streaming

Anfrage stellen

Für die Suchmethode ist ein SearchGoogleAdsRequest erforderlich, das aus den folgenden Attributen besteht:

  • Ein customer_id
  • Eine Google Ads Query Language-Abfragequery, die 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 sollen
  • (Nur GoogleAdsService.Search) Ein page_size, um anzugeben, wie viele Objekte in einer einzelnen Antwort zurückgegeben werden sollen, wenn die Paginierung verwendet wird.
  • (Nur GoogleAdsService.Search) Optionales page_token zum Abrufen des nächsten Batches von Ergebnissen bei Verwendung der Paginierung.

Weitere Informationen zur Google Ads-Abfragesprache finden Sie im Leitfaden zur Google Ads-Abfragesprache.

Antwort verarbeiten

GoogleAdsService gibt eine Liste von GoogleAdsRow-Objekten zurück.

Jede GoogleAdsRow steht für ein Objekt, das von einer Abfrage zurückgegeben wird. Sie besteht aus einer Reihe von Attributen, die basierend auf den in der SELECT-Klausel angeforderten Feldern ausgefüllt werden. Attribute, die nicht in der SELECT-Klausel enthalten sind, werden in den GoogleAdsRow-Objekten in der Antwort nicht eingefügt.

Auch wenn ein ad_group_criterion ein status-Attribut hat, wird das Feld status des ad_group_criterion-Attributs der Zeile in einer Antwort für eine Abfrage nicht ausgefüllt, wenn die SELECT-Klausel ad_group_criterion.status nicht enthält. Ebenso wird das campaign-Attribut der Zeile nicht ausgefüllt, wenn die SELECT-Klausel keine Felder aus der campaign-Ressource enthält.

Jede GoogleAdsRow kann unterschiedliche Attribute und Messwerte wie eine andere Zeile im selben Ergebnissatz haben. Die Zeilen sollten daher 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 über andere Oberflächen wie die Google Ads-Benutzeroberfläche erstellt worden sein. Sie können Messwerte auswählen, wenn eine Ressource den Typ UNKNOWN hat, aber Sie können die Ressource nicht über die API ändern. Ein Beispiel hierfür wäre eine neue Kampagne oder Anzeige, die in der Benutzeroberfläche eingeführt, aber von der von Ihnen abgefragten API-Version nicht unterstützt wird.

Beachten Sie dabei Folgendes:

  • Eine Ressource mit dem Typ UNKNOWN kann später unterstützt werden oder unbefristet UNKNOWN bleiben.
  • Neue Objekte vom Typ UNKNOWN können jederzeit erscheinen. Diese Objekte sind abwärtskompatibel, da der Aufzählungswert bereits verfügbar ist. Mit dieser Änderung werden Ressourcen eingeführt, die Ihnen einen genauen Überblick über Ihr Konto geben. Die UNKNOWN-Ressource kann aufgrund neuer Aktivitäten in Ihrem Konto über andere Oberflächen oder wenn eine Ressource nicht mehr unterstützt wird, angezeigt werden.
  • UNKNOWN-Ressourcen können detaillierte Messwerte enthalten, die abgefragt werden können.
  • UNKNOWN-Ressourcen sind in der Google Ads-Benutzeroberfläche in der Regel vollständig sichtbar.
  • UNKNOWN-Ressourcen können in der Regel nicht mutiert werden.

Segmentierung

Die Antwort enthält ein GoogleAdsRow für jede Kombination der folgenden Elemente:

  • Instanz der Hauptressource, die in der FROM-Klausel angegeben ist
  • Wert jedes ausgewählten segment-Felds

Die Antwort für eine Abfrage, bei der FROM campaign ausgewählt wird und segments.ad_network_type und segments.date in der SELECT-Klausel enthalten sind, würde beispielsweise eine Zeile für jede Kombination der folgenden Werte enthalten:

  • 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, nicht zu einer Zeile pro eindeutigem Wert des Felds campaign.status.

Zurück
Objekte ändern und prüfen
Weiter
Ressourcenmetadaten