Scorrere i risultati

Puoi scorrere i risultati recuperati con GoogleAdsService.Search anziché scaricare l'intero set di risultati contemporaneamente. Per una panoramica della generazione di report con l'API Google Ads, consulta la panoramica dei report.

Search restituisce pagine fisse di un massimo di 10.000 righe. L'impostazione di page_size in SearchGoogleAdsRequest è obsoleta e restituisce un RequestError.PAGE_SIZE_NOT_SUPPORTED errore.

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 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 il della richiesta page_token al 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 automaticamente l'impaginazione. 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 pagina successive siano più veloci della richiesta iniziale. Tieni presente che i valori next_page_token hanno un tempo di attività (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.

Per sfruttare i dati memorizzati nella cache, la query deve rimanere identica nelle richieste successive. Le richieste paginate successive non vengono conteggiate come operazioni aggiuntive ai fini della quota di operazioni giornaliera 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.