Die Google Ads API bietet einen einheitlichen Mechanismus zum Abrufen von Attributen und Berichten zu Messwerten, mit dem Sie Abfragen mithilfe der Google Ads Query Language erstellen können. So sind komplexe Abfragen möglich, die große Datenmengen zu einzelnen Google Ads-Konten zurückgeben können.
Sie können Abfragen mit der Methode Search oder SearchStream erstellen.
Beide Methoden unterstützen dieselben Abfragen und geben entsprechende Ergebnisse zurück. Die Methode Search gibt Daten in Seiten mit einer festen Größe von 10.000 Zeilen zurück. So können Sie eine Ergebnismenge mithilfe der Paginierung durchlaufen. Dies kann bei geringer Bandbreite oder unzuverlässigen Netzwerkbedingungen von Vorteil sein, z. B. um eine große Ergebnismenge in kleinere Antworten zu segmentieren, die bei einem Verbindungsverlust noch einmal abgerufen werden können. Die Methode SearchStream hingegen streamt die gesamte Ergebnismenge in einer einzigen Antwort zurück, was für den Abruf von Bulk-Daten effizienter sein kann.
Sowohl Search als auch SearchStream verwenden dieselbe Basis-URL:
https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/googleAds
POST /v26/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_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-Parameter wiederholen, der die Werte aus der vorherigen Anfrage enthält, wird die nächste Ergebnisseite abgerufen:
POST /v26/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_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 zu searchStream (pageToken ist für SearchStream nicht erforderlich):
POST /v26/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_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'" }