L'API Search Ads 360 Reporting offre report unificati sulle metriche e sul recupero degli attributi meccanismo di attenzione che ti consente di creare query utilizzando la funzionalità Query di Search Ads 360 Lingua. Ciò permette query complesse che possono restituire grandi quantità di dati singoli account Search Ads 360.
Puoi creare query utilizzando il metodo Search o SearchStream.
Entrambi i metodi supportano le stesse query e restituiscono risultati equivalenti. La
Il metodo Search restituisce dati in dimensioni di pagina personalizzabili, consentendoti di ripetere l'iterazione
rispetto a un set di risultati
usando l'impaginazione. Questo potrebbe essere vantaggioso in caso di scarsa larghezza di banda
o inaffidabili, ad esempio, per segmentare un insieme di risultati di grandi dimensioni
in risposte più piccole che possono essere recuperate di nuovo in caso di perdita della connessione. La
SearchStream, invece, trasmette in streaming l'intero risultato impostato su
una singola risposta, che può essere più efficiente per il recupero di dati in blocco.
Sia Search sia SearchStream utilizzano lo stesso URL di base:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID /searchAds360
Il metodo di ricerca basata sulle pagine accetta un parametro facoltativo pageSize che limita
il numero di risultati restituiti in una singola risposta dell'API.
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'" }
Se i risultati contengono più righe di pageSize, viene restituito un nextPageToken
restituito nella risposta:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
La ripetizione della stessa query con un pageToken aggiunto con il valore indicato sopra per i recuperi
alla pagina successiva di risultati:
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" }
Per utilizzare il metodo SearchStream, che restituisce tutti i risultati in un unico flusso di dati
risposta, cambia semplicemente il metodo del servizio nell'URL in searchStream
(pageSize e pageToken non sono obbligatori per SearchStream):
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'" }