Puoi scorrere i risultati recuperati con
GoogleAdsService.Search invece di scaricare l'intero set di risultati
in una sola volta. Per una panoramica dei report con l'API Google Ads, consulta la panoramica dei report.
Search restituisce pagine fisse di massimo 10.000 righe. L'impostazione page_size in SearchGoogleAdsRequest è deprecata e restituisce un errore RequestError.PAGE_SIZE_NOT_SUPPORTED.
Query di esempio e impaginazione
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 contiene 10.000 oggetti GoogleAdsRow nella prima risposta, insieme a un next_page_token.
Per recuperare le 10.000 righe successive, invia nuovamente la richiesta, ma aggiorna il page_token della richiesta con il next_page_token della risposta:
{
"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",
"pageToken": "CN3q9...example_token..."
}
Tieni presente che next_page_token non viene compilato nella risposta che contiene l'ultimo gruppo di righe.
Le nostre librerie client gestiscono automaticamente l'impaginazione. Devi solo eseguire l'iterazione delle 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 fino a quando non viene recuperato l'intero set di dati. Se utilizzi REST anziché gRPC, devi effettuare esplicitamente una richiesta per ogni nuova pagina.
Memorizzazione nella cache e scadenza dei token di pagina
L'API Google Ads memorizza internamente nella cache il set di dati in modo che le richieste di pagine successive siano più veloci della richiesta iniziale. Tieni presente che i valori next_page_token hanno una durata (TTL) limitata e scadono se non vengono utilizzati entro un breve periodo (circa due ore). Se un token di pagina scade, l'API restituisce un errore e devi avviare una nuova query.
La query deve rimanere identica nelle richieste successive per sfruttare i dati memorizzati nella cache. Le richieste con pagine successive non vengono conteggiate come operazioni aggiuntive per la quota di operazioni giornaliere per l'accesso Explorer e l'accesso di base. Se la query è diversa e viene inviata insieme allo stesso token di pagina, viene restituito un errore.