Puoi scorrere i risultati recuperati con GoogleAdsService.Search
invece di scaricare l'intero insieme di risultati contemporaneamente. 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 superiore a 10.000, viene comunque utilizzato 10.000.
Ad esempio, considera 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
oggetti GoogleAdsRow nella prima risposta, insieme a un
next_page_token.
Per recuperare le successive 10.000 righe, invia di nuovo la richiesta, ma aggiorna
page_token della richiesta 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 automaticamente la paginazione. Devi solo scorrere le righe della risposta. Quando vengono restituite tutte le righe della pagina corrente, 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 internamente nella cache l'intero set di dati, quindi le richieste successive sono più veloci di quella iniziale.
La query deve rimanere esattamente la stessa nelle richieste successive per sfruttare i dati memorizzati nella cache. Le richieste non verranno conteggiate ai fini della quota, in particolare per il livello di accesso Explorer e il livello di accesso Basic. Se la query è diversa e viene inviata con lo stesso token di pagina, viene restituito un errore.