Die Google Ads API bietet einen einheitlichen Mechanismus zum Abrufen von Attributen und zum Erstellen von Berichten zu Messwerten . Damit können Sie Abfragen mit der Google Ads Query Language erstellen. So lassen sich komplexe Abfragen erstellen, die große Datenmengen zu einzelnen Google Ads-Konten zurückgeben können.
Sie können Abfragen mit den Methoden Search oder SearchStream erstellen.
Beide Methoden unterstützen dieselben Abfragen und geben gleichwertige Ergebnisse zurück. Die Methode Search gibt Daten auf Seiten mit einer festen Größe von 10.000 Zeilen zurück. So können Sie ein Ergebnis-Set mithilfe der Paginierung durchlaufen. Das kann bei geringer Bandbreite oder unzuverlässigen Netzwerkbedingungen von Vorteil sein, z. B. um ein großes Ergebnis-Set in kleinere Antworten zu segmentieren, die bei Verlust der Verbindung noch einmal abgerufen werden können. Die Methode SearchStream hingegen streamt das gesamte Ergebnis-Set in einer einzigen Antwort zurück. Das kann für den Massenabruf von Daten effizienter sein.
Sowohl Search als auch SearchStream verwenden dieselbe Basis-URL:
https://googleads.googleapis.com/v25/customers/CUSTOMER_ID/googleAds
POST /v25/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
Wenn die Ergebnisse mehr als 10.000 Zeilen enthalten,wird in der Antwort ein nextPageToken zurückgegeben:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
Wenn Sie dieselbe Abfrage mit einem pageToken wiederholen, das die Werte aus der vorherigen Anfrage enthält, wird die nächste Seite mit Ergebnissen abgerufen:
POST /v25/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
Wenn Sie die Methode SearchStream verwenden möchten, die alle Ergebnisse in einer einzigen gestreamten Antwort zurückgibt, ändern Sie die Dienstmethode in der URL in searchStream (pageToken ist für SearchStream nicht erforderlich):
POST /v25/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }