Die Google Ads API bietet einen einheitlichen Abrufmechanismus für Attribute und Messwertberichte, mit dem Sie Abfragen mit der Google Ads-Abfragesprache erstellen können. So sind komplexe Abfragen möglich, mit denen große Datenmengen zu einzelnen Google Ads-Konten zurückgegeben werden können.
Sie können Abfragen mit der Methode Search oder SearchStream erstellen.
Beide Methoden unterstützen dieselben Abfragen und geben dieselben Ergebnisse zurück. Die Methode Search gibt Daten auf Seiten mit fester Größe mit 10.000 Zeilen zurück, sodass Sie eine Ergebnismenge mithilfe von Paginierung iterieren können. Das kann bei geringer Bandbreite oder bei unzuverlässigen Netzwerkbedingungen von Vorteil sein, z. B. um einen großen Ergebnissatz in kleinere Antworten zu segmentieren, die bei einer Verbindungsunterbrechung neu abgerufen werden können. Bei der Methode SearchStream hingegen wird das gesamte Ergebnis in einer einzigen Antwort gestreamt, was beim Abrufen von Bulk-Daten effizienter sein kann.
Search und SearchStream verwenden dieselbe Basis-URL:
https://googleads.googleapis.com/v18/customers/CUSTOMER_ID/googleAds
POST /v18/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 Ergebnisseite abgerufen:
POST /v18/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 gestreamten Antwort zurückgibt, ändern Sie die Dienstmethode in der URL zu searchStream. pageToken ist für SearchStream nicht erforderlich:
POST /v18/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'" }