Die Google Ads API bietet einen einheitlichen Mechanismus zum Abrufen von Attributen und Messwerten, mit dem Sie Abfragen mit der Google Ads Query Language erstellen können. Dies ermöglicht komplexe Abfragen, bei denen große Mengen an Daten 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 äquivalente Ergebnisse zurück. Die Methode Search
gibt Daten in anpassbaren Seitengrößen zurück, sodass Sie eine Ergebnismenge mithilfe von Paginierung durchlaufen können. Dies kann bei niedriger Bandbreite oder unzuverlässigen Netzwerkbedingungen vorteilhaft sein, z. B. um eine große Ergebnismenge in kleinere Antworten zu unterteilen, die bei Verlust einer Verbindung noch einmal abgerufen werden können. Bei der Methode SearchStream
wird dagegen der gesamte Ergebnissatz 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/v17/customers/CUSTOMER_ID/googleAds
Die seitenbasierte Suchmethode verwendet den optionalen Parameter pageSize
, der begrenzt, wie viele Ergebnisse in einer einzelnen API-Antwort zurückgegeben werden.
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "pageSize": 10000, "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 Zeilen als pageSize
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
mit dem obigen Wert wiederholen, wird die nächste Ergebnisseite abgerufen:
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "pageSize": 10000, "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 einfach die Dienstmethode in der URL in searchStream
(pageSize
und pageToken
sind für SearchStream
nicht erforderlich):
POST /v17/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'" }