GoogleAdsService
ist das einheitliche Objekt.
-Abruf- und Berichtsdienst 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 Ergebnisse zurückgeben in
auf zwei Arten:
GoogleAdsService.SearchStream
gibt alle Zeilen in einer einzigen Streaming-Antwort zurück, was für großen Ergebnissätzen (mehr als 10.000 Zeilen). Das könnte besser sein wenn Ihre Batch-Anwendung so viele Daten so schnell wie möglich herunterladen möchte, möglich.GoogleAdsService.Search
trennt sich aus großen Antworten in übersichtliche Ergebnisseiten ziehen. Dies könnte mehr sein wenn Ihre interaktive Anwendung eine Ergebnisseite .
Weitere Informationen zum Paging im Vergleich zum Streaming
Anfrage stellen
Die Suchmethode erfordert eine
SearchGoogleAdsRequest
, die sich aus Folgendem zusammensetzt:
der folgenden Attribute:
- Ein
customer_id
- Eine Google Ads Query Language-
query
, die angibt, welche Ressource abgefragt werden soll, welche Attribute Segmente, Messwerte, die abgerufen werden sollen, sowie die Bedingungen, welche Objekte zurückgegeben werden, - (nur
GoogleAdsService.Search
) Apage_size
, um anzugeben, wie viele Objekte in einer einzelnen Antwort zurückgegeben werden sollen, wenn mit Plaging. - (nur
GoogleAdsService.Search
) Ein Optionalespage_token
-Objekt zum Abrufen des nächsten Batches von Ergebnissen bei Verwendung paging verwenden.
Weitere Informationen zur Google Ads Query Language finden Sie unter Google Ads Query Language. .
Antwort verarbeiten
GoogleAdsService
gibt eine Liste von
GoogleAdsRow
-Objekte.
Jeder GoogleAdsRow
steht für ein Objekt, das von einer Abfrage zurückgegeben wird, und besteht aus einem
Gruppe von Attributen, die basierend auf den angeforderten Feldern ausgefüllt werden.
SELECT
-Klausel angegeben werden. Attribute, die nicht in der SELECT
-Klausel enthalten sind, sind nicht
in die GoogleAdsRow
-Objekte in der Antwort eingefügt.
Beispiel: Obwohl ad_group_criterion
ein status
-Attribut hat, ist das Attribut
Das Feld status
des Attributs ad_group_criterion
der Zeile wird in
Antwort für eine Abfrage, bei der die SELECT
-Klausel keine
ad_group_criterion.status
. Entsprechend lautet das Attribut campaign
der Zeile
wird nicht ausgefüllt, wenn die SELECT
-Klausel keine Felder aus der
campaign
.
Jeder GoogleAdsRow
kann unterschiedliche Attribute und Messwerte aus einer anderen Zeile haben
in der gleichen Ergebnismenge. Daher sollten die Zeilen als Objekte und nicht
feste Zeilen einer Tabelle.
UNKNOWN enum-Typen
Ressourcen, die vom Typ UNKNOWN
zurückgegeben werden, werden in nicht vollständig unterstützt.
dieser API-Version. Diese Ressourcen können durch andere
wie die Google Ads-Benutzeroberfläche. Sie können Messwerte auswählen, wenn eine Ressource
Typ von UNKNOWN
, aber Sie können die Ressource nicht über die API ändern. Eine
z. B. eine neue Kampagne oder Anzeige in der Benutzeroberfläche,
wird in der API-Version, die Sie abfragen, nicht unterstützt.
Beachten Sie dabei Folgendes:
- Eine Ressource mit dem Typ
UNKNOWN
kann später unterstützt werden oder beiUNKNOWN
bleiben auf unbestimmte Zeit. - 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. genaue Ansicht Ihres Kontos erhalten. Die RessourceUNKNOWN
kann aus folgenden Gründen angezeigt werden: neue Aktivitäten in Ihrem Konto über andere Benutzeroberflächen oder wenn eine Ressource wird nicht mehr unterstützt. UNKNOWN
Ressourcen können detaillierte Messwerte angehängt werden, die abfragbar sind.UNKNOWN
Ressourcen sind normalerweise vollständig in der Google Ads-Benutzeroberfläche sichtbar.UNKNOWN
-Ressourcen können im Allgemeinen nicht geändert werden.
Segmentierung
Die Antwort würde ein GoogleAdsRow
für jede Kombination der
Folgendes:
- Instanz der in der
FROM
-Klausel angegebenen Hauptressource - Wert jedes ausgewählten
segment
-Felds
Die Antwort auf eine Abfrage, die FROM campaign
auswählt und
segments.ad_network_type
und segments.date
in der SELECT
-Klausel
enthalten eine Zeile für jede Kombination der folgenden Elemente:
campaign
segments.ad_network_type
segments.date
Die Ergebnisse werden implizit nach jeder Instanz der Hauptressource segmentiert, nicht nach 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 des
campaign.status
.