L'API Search Ads 360 Reporting ha un meccanismo unificato di recupero degli attributi e generazione di report sulle metriche che ti consente di creare query utilizzando il linguaggio di query Search Ads 360. Ciò consente query complesse che possono restituire grandi quantità di dati su singoli account Search Ads 360.
Puoi creare query utilizzando uno dei metodi Search o SearchStream.
Entrambi i metodi supportano le stesse query e restituiscono risultati equivalenti. Il metodo
Search restituisce i dati in dimensioni di pagina personalizzabili, consentendoti di scorrere
un insieme di risultati utilizzando la paginazione. Ciò potrebbe essere vantaggioso in condizioni di larghezza di banda ridotta
o di rete inaffidabile, ad esempio per segmentare un ampio insieme di risultati
in risposte più piccole che possono essere recuperate nuovamente se una connessione viene persa. Il metodo
SearchStream, invece, trasmette l'intero insieme di risultati in
una singola risposta, il che può essere più efficiente per il recupero dei dati collettivi.
Sia Search sia SearchStream utilizzano lo stesso URL di base:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
Il metodo di ricerca basato sulla pagina accetta un parametro pageSize facoltativo che limita il numero di risultati restituiti in una singola risposta API.
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'" }
Se nei risultati sono presenti più righe di pageSize, nella risposta viene restituito un nextPageToken:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
Se ripeti la stessa query con un pageToken aggiunto con il valore precedente, viene recuperata
la pagina successiva dei risultati:
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" }
Per utilizzare il metodo SearchStream, che restituisce tutti i risultati in un'unica risposta
in streaming, è sufficiente modificare il metodo del servizio nell'URL in searchStream
(pageSize e pageToken non sono richiesti da SearchStream):
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'" }