Die Google Ads API bietet einen einheitlichen Mechanismus zum Abrufen von Attributen und zum Erstellen von Berichten zu Messwerten, mit dem Sie Abfragen mit der Google Ads-Abfragesprache erstellen können. So lassen sich komplexe Abfragen ausführen, 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 gleichwertige 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 ein Ergebnis-Set mithilfe der Paginierung durchlaufen. Dies kann bei geringer Bandbreite oder unzuverlässigen Netzwerkbedingungen von Vorteil sein, z. B. um ein großes Ergebnis in kleinere Antworten zu segmentieren, die bei Verbindungsverlust neu abgerufen werden können. Die Methode SearchStream hingegen streamt das gesamte Ergebnisset in einer einzigen Antwort zurück, was für den Massendatenabruf effizienter sein kann.
Sowohl Search als auch SearchStream verwenden dieselbe Basis-URL:
https://googleads.googleapis.com/v20/customers/CUSTOMER_ID/googleAds
POST /v20/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 Anfrage mit einem pageToken wiederholen, das die Werte aus der vorherigen Anfrage enthält, wird die nächste Ergebnisseite abgerufen:
POST /v20/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 einzelnen Streamingantwort zurückgibt, ändern Sie die Dienstmethode in der URL zu searchStream (pageToken ist für SearchStream nicht erforderlich):
POST /v20/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'" }