Puoi scorrere i risultati recuperati con GoogleAdsService.Search
anziché scaricare contemporaneamente l'intero set di risultati. Per una panoramica dei
report con l'API Google Ads, consulta la
guida ai report.
I risultati vengono restituiti in pagine di massimo 10.000 righe. Se page_size nella richiesta non è impostato, il valore predefinito è 10.000. Se page_size è impostato su un valore maggiore di 10.000, viene comunque utilizzato 10.000.
Ad esempio, prendi in considerazione la seguente query:
SELECT
ad_group.id,
ad_group_criterion.type,
ad_group_criterion.criterion_id,
ad_group_criterion.keyword.text,
ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD
Se il tuo account contiene 50.000 parole chiave, il set di risultati conterrà 10.000
GoogleAdsRow oggetti nella prima risposta, insieme a un
next_page_token.
Per recuperare le successive 10.000 righe, invia di nuovo la richiesta, ma aggiorna
della richiesta page_token con next_page_token della risposta. Tieni presente che
next_page_token non viene compilato nella risposta che contiene l'
ultimo batch di righe.
Le nostre librerie client gestiscono la paginazione automaticamente. Devi solo eseguire l'iterazione attraverso le righe della risposta. Quando tutte le righe della pagina corrente sono state restituite, la libreria client recupera automaticamente una nuova pagina di righe per tuo conto finché non viene recuperato l'intero set di dati. Se utilizzi REST anziché gRPC, devi effettuare esplicitamente una richiesta per ogni nuova pagina.
L'API Google Ads memorizza nella cache internamente l'intero set di dati, quindi le richieste successive sono più veloci di quella iniziale.
Per sfruttare i dati memorizzati nella cache, la query deve rimanere esattamente la stessa nelle richieste successive. Le richieste non contribuiscono alla quota, in particolare per il livello di accesso Explorer e livello di accesso di base. Se la query è diversa e viene inviata insieme allo stesso token di pagina, viene restituito un errore.