Die Google Ads API bietet eine einheitliche Berichterstellung für den Attributabruf und die Messwerte. Mechanismus können Sie mithilfe von Google Ads-Abfragen Sprache: Dies ermöglicht komplexe Abfragen, die große Mengen an Daten über einzelne Google Ads-Konten.
Sie können Abfragen mit der Methode Search oder SearchStream erstellen.
Beide Methoden unterstützen dieselben Abfragen und geben äquivalente Ergebnisse zurück. Die
Die Methode Search gibt Daten auf Seiten mit fester Größe mit 10.000 Zeilen zurück.
, um eine Ergebnismenge mithilfe von Paginierung zu iterieren. Dies könnte vorteilhaft sein, wenn
oder unzuverlässigen Netzwerkbedingungen auftreten, z. B. um eine große
Ergebnissatz in kleinere Antworten, die erneut abgerufen werden können, wenn eine Verbindung
verloren. Bei der Methode SearchStream wird hingegen das gesamte Ergebnis gestreamt.
in einer einzigen Antwort, was bei Bulk-Daten effizienter sein kann,
Datenabruf.
Search und SearchStream verwenden dieselbe Basis-URL:
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
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
{
"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,ist nextPageToken
zurückgegeben:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
Die Wiederholung derselben Abfrage mit einem pageToken, der mit den Werten aus dem
Mit der vorherigen Anfrage 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
{
"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"
}
So verwenden Sie die Methode SearchStream, die alle Ergebnisse in einem einzelnen gestreamten Stream zurückgibt
ändern Sie die Dienstmethode in der URL zu searchStream.
(pageSize und pageToken werden von SearchStream nicht benötigt):
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'"
}