Die Search Ads 360 Reporting API hat einen einheitlichen Mechanismus zum Abrufen von Attributen und zur Berichterstellung für Messwerte, sodass Sie Abfragen mit der Search Ads 360 Query Language erstellen können. Dies ermöglicht komplexe Abfragen, die große Mengen an Daten 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 ä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://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
Die seitenbasierte Suchmethode verwendet einen optionalen pageSize
-Parameter, der einschränkt, 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: 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 obigen 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'" }