Die Search Ads 360 Reporting API bietet einen einheitlichen Attributabruf und Messwertberichte. Mechanismus mit der Sie mithilfe der Search Ads 360-Abfrage Sprache: Dies ermöglicht komplexe Abfragen, die große Mengen an Daten über einzelne Search Ads 360-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 in anpassbaren Seitengrößen zurück und ermöglicht so eine Wiederholung.
für eine Ergebnismenge mithilfe von Paginierung. Dies könnte bei niedriger Bandbreite vorteilhaft sein.
oder unzuverlässigen Netzwerkbedingungen zu finden, z. B. um einen großen Ergebnissatz zu segmentieren,
in kleinere Antworten umzuwandeln, die bei Verbindungsverlust erneut abgerufen werden können. Die
Bei der Methode SearchStream wird hingegen das gesamte Ergebnis in
eine einzige Antwort, was beim
Bulk-Abruf von Daten effizienter sein kann.
Search und SearchStream verwenden dieselbe Basis-URL:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID /searchAds360
Für die seitenbasierte Suche wird ein optionaler pageSize-Parameter verwendet, der
wie viele Ergebnisse in einer einzelnen API-Antwort zurückgegeben werden.
POST /v0/customers/CUSTOMER_ID /searchAds360:search HTTP/1.1 Host: searchAds360.googleapis.com Content-Type: application/json Authorization: BearerACCESS_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, ist 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, werden diese abgerufen.
zur nächsten Ergebnisseite:
POST /v0/customers/CUSTOMER_ID /searchAds360:search HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: BearerACCESS_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" }
So verwenden Sie die Methode SearchStream, die alle Ergebnisse in einem einzelnen gestreamten Stream zurückgibt
ändern Sie einfach die Servicemethode in der URL zu searchStream.
(pageSize und pageToken sind für SearchStream nicht erforderlich):
POST /v0/customers/CUSTOMER_ID /searchAds360:searchStream HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: BearerACCESS_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'" }