Die Search Ads 360 Reporting API bietet einen einheitlichen Abrufmechanismus für Attribute und Berichtsmechanismus für Messwerte, mit dem Sie Abfragen mit der Search Ads 360-Abfragesprache erstellen können. So sind komplexe Abfragen möglich, mit denen große Datenmengen zu einzelnen Search Ads 360-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 dieselben 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 bei unzuverlässigen Netzwerkbedingungen von Vorteil sein, z. B. um einen großen Ergebnissatz in kleinere Antworten zu segmentieren, die bei einer Verbindungsunterbrechung neu abgerufen werden können. Bei der Methode SearchStream wird dagegen der gesamte Ergebnissatz in einer einzigen Antwort zurückgestreamt, 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 nimmt einen optionalen Parameter pageSize an, mit dem die Anzahl der Ergebnisse in einer einzelnen API-Antwort begrenzt wird.
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 und 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'" }