Objekte werden abgerufen

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) A page_size, um anzugeben, wie viele Objekte in einer einzelnen Antwort zurückgegeben werden sollen, wenn mit Plaging.
  • (nur GoogleAdsService.Search) Ein Optionales page_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 bei UNKNOWN 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 Ressource UNKNOWN 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.