Scorrere i risultati

Puoi scorrere le pagine dei risultati recuperati con GoogleAdsService.Search anziché scaricare l'intero insieme di risultati contemporaneamente. Per una panoramica dei report con l'API Google Ads, consulta la panoramica dei report.

Search restituisce pagine fisse fino a 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 successive 10.000 righe, invia di nuovo 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 batch di righe.

Le nostre librerie client gestiscono la paginazione automaticamente. Devi solo scorrere 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.

Memorizzazione nella cache e scadenza del 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 un TTL limitato e scadono se non vengono utilizzati entro un breve periodo di tempo (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 di pagine successive non vengono conteggiate come operazioni aggiuntive ai fini della quota giornaliera di operazioni per l'accesso Explorer e l'accesso di base. Se la query è diversa e viene inviata con lo stesso token di pagina, viene restituito un errore.