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'"
}