Die Google Ads API verfügt über einen einheitlichen Mechanismus zum Abrufen von Attributen und zur Berichterstellung für Messwerte, sodass 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 mithilfe von Paginierung über einen Ergebnissatz iterieren können. Dies kann bei niedriger Bandbreite oder unzuverlässigen Netzwerkbedingungen von Vorteil sein, z. B. um eine große Ergebnismenge in kleinere Antworten zu segmentieren, die bei unterbrochener Verbindung noch einmal abgerufen werden können. Bei der Methode SearchStream wird hingegen der gesamte Ergebnissatz in einer einzigen Antwort zurückgestreamt, was beim Abrufen von Bulk-Daten effizienter sein kann.
Search und SearchStream verwenden dieselbe Basis-URL:
https://googleads.googleapis.com/v16/customers/CUSTOMER_ID/googleAds
Die seitenbasierte Suchmethode verwendet einen optionalen pageSize-Parameter, der einschränkt, wie viele Ergebnisse in einer einzelnen API-Antwort zurückgegeben werden.
POST /v16/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 und dem obigen Wert wiederholen, wird die nächste Ergebnisseite abgerufen:
POST /v16/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 /v16/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'"
}