Die Search Ads 360 Reporting API bietet einen einheitlichen Mechanismus zum Abrufen von Attributen und zum Erstellen von Berichten zu Messwerten. Damit können Sie Abfragen mit der Search Ads 360 Query Language erstellen. So lassen sich komplexe Abfragen ausführen, die große Datenmengen zu einzelnen Search Ads 360-Konten zurückgeben können.
Sie können Abfragen mit der Methode Search oder SearchStream erstellen.
Beide Methoden unterstützen dieselben Abfragen und geben gleichwertige Ergebnisse zurück. Die Methode Search gibt Daten in anpassbaren Seitengrößen zurück. So können Sie ein Ergebnis-Set mithilfe der Paginierung durchlaufen. Das kann bei geringer Bandbreite oder unzuverlässigen Netzwerkbedingungen von Vorteil sein, z. B. um ein großes Ergebnis-Set in kleinere Antworten zu segmentieren, die bei einem Verbindungsverlust neu abgerufen werden können. Die Methode SearchStream hingegen streamt das gesamte Ergebnis-Set in einer einzigen Antwort zurück, was für den Bulk-Datenabruf effizienter sein kann.
Sowohl Search als auch SearchStream verwenden dieselbe Basis-URL:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
Die seitenbasierte Suchmethode verwendet einen optionalen pageSize-Parameter, der die Anzahl der Ergebnisse begrenzt, die 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: Bearer ACCESS_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 oben genannten Wert wiederholen, wird die nächste Ergebnisseite abgerufen:
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_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 /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_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'" }