Objekte werden abgerufen

Die GoogleAdsService ist der einheitliche Dienst zum Abrufen von Objekten und zur Berichterstellung der Google Ads API. Der Dienst verfügt über Methoden, die:

• Spezifische Attribute von Objekten abrufen
• Leistungsmesswerte für Objekte basierend auf einem Zeitraum abrufen
• Ordnen Sie Objekte anhand ihrer Attribute.
• 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 auf zwei Arten Ergebnisse zurückgeben:

• GoogleAdsService.SearchStream gibt alle Zeilen in einer einzelnen Streamingantwort zurück,was bei großen Ergebnissätzen (mehr als 10.000 Zeilen) effizienter ist. Dies ist möglicherweise sinnvoller, wenn Ihre Batch-Anwendung so viele Daten so schnell wie möglich herunterladen möchte.
• GoogleAdsService.Search teilt große Antworten in überschaubare Ergebnisseiten auf. Dies könnte sinnvoller sein, wenn in Ihrer interaktiven Anwendung jeweils eine Seite mit Ergebnissen angezeigt wird.

Weitere Informationen zum Paging im Vergleich zum Streaming

Anfrage stellen

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

• Ein customer_id
• query einer Google Ads Query Language API, die angibt, welche Ressource abgefragt werden soll, welche Attribute, Segmente und Messwerte abgerufen werden sollen und mit welchen Bedingungen eingeschränkt wird, welche Objekte zurückgegeben werden
• (Nur GoogleAdsService.Search) Eine page_size, die angibt, wie viele Objekte in einer einzelnen Antwort zurückgegeben werden sollen, wenn Paging verwendet wird.
• (Nur GoogleAdsService.Search) Ein optionaler page_token zum Abrufen des nächsten Batches von Ergebnissen bei Verwendung von Paging.

Weitere Informationen zur Google Ads Query Language finden Sie im Leitfaden zur Google Ads Query Language.

Antwort verarbeiten

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

Jede GoogleAdsRow stellt ein Objekt dar, das von einer Abfrage zurückgegeben wird. Sie 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 nicht für die GoogleAdsRow-Objekte in der Antwort eingefügt.

Beispiel: Obwohl ein ad_group_criterion ein status-Attribut hat, wird das Feld status des ad_group_criterion-Attributs der Zeile nicht in einer Antwort auf eine Abfrage ausgefüllt, bei der die SELECT-Klausel ad_group_criterion.status nicht enthält. Ebenso wird das Attribut campaign der Zeile nicht mit Daten gefüllt, wenn die SELECT-Klausel keine Felder aus der Ressource campaign enthält.

Jede GoogleAdsRow kann unterschiedliche Attribute und Messwerte aus einer anderen Zeile im selben Ergebnissatz haben. Daher sollten die Zeilen als Objekte und nicht als feste Zeilen einer Tabelle angesehen werden.

UNKNOWN enum-Typen

Ressourcen, die vom Typ UNKNOWN zurückgegeben werden, werden in dieser API-Version nicht vollständig unterstützt. Diese Ressourcen können auch über andere Benutzeroberflächen erstellt worden sein, etwa über die Google Ads-Benutzeroberfläche. Sie können Messwerte auswählen, wenn eine Ressource vom Typ UNKNOWN ist, aber nicht über die API mutieren. Ein Beispiel hierfür wäre, wenn eine neue Kampagne oder Anzeige in der Benutzeroberfläche eingeführt wird, aber in 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 UNKNOWN unbegrenzt bleiben.
• Neue Objekte des Typs UNKNOWN können jederzeit auftauchen. Diese Objekte sind abwärtskompatibel, da der enum-Wert bereits verfügbar ist. Ressourcen werden mit dieser Änderung eingeführt, sobald sie verfügbar sind, damit Sie eine genaue Ansicht Ihres Kontos erhalten. Die Ressource UNKNOWN kann aufgrund neuer Aktivitäten in Ihrem Konto über andere Benutzeroberflächen angezeigt werden oder wenn eine Ressource nicht mehr unterstützt wird.
• UNKNOWN-Ressourcen können detaillierte Messwerte angehängt werden, die abgefragt werden können.
• UNKNOWN Ressourcen sind normalerweise vollständig in der Google Ads-Benutzeroberfläche sichtbar.
• UNKNOWN-Ressourcen können im Allgemeinen nicht geändert werden.

Segmentierung

In der Antwort würde eine GoogleAdsRow für jede Kombination der folgenden Elemente enthalten:

• Instanz der in der FROM-Klausel angegebenen Hauptressource
• Wert jedes ausgewählten segment-Felds

Beispielsweise würde die Antwort auf eine Abfrage, die FROM campaign auswählt und segments.ad_network_type und segments.date in der SELECT-Klausel enthält, eine Zeile für jede Kombination der folgenden Elemente 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

zu einer Zeile pro Kampagne und nicht zu einer Zeile pro eindeutigem Wert im Feld campaign.status.