GoogleAdsService.Search
supporta
paging con dimensioni di pagina fisse di 10.000 righe. Il set di risultati della query è suddiviso
in risposte multiple, ognuna delle quali 10.000 oggetti.
Ad esempio, per 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 l'account contiene 50.000 parole chiave, l'insieme di risultati conterrà 10.000
GoogleAdsRow
oggetti nella prima risposta,
insieme a next_page_token
.
Per recuperare le successive 10.000 righe, invia di nuovo la richiesta, ma aggiorna il valore
page_token
della richiesta alla risposta
next_page_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 il paging. Devi solo ripetere tra le righe della risposta. Quando tutte le righe della pagina corrente sono vengono restituiti, la libreria client recupera automaticamente una nuova pagina di righe fino a quando non viene recuperato l'intero set di dati. Se utilizzi REST invece di gRPC, devi effettuare esplicitamente una richiesta per ogni nuova pagina.
L'API Google Ads memorizza internamente nella cache l'intero set di dati, pertanto le richieste successive vengono più veloce di quella iniziale.
La tua query deve rimanere esattamente la stessa nelle richieste successive per approfittare dei dati memorizzati nella cache; le richieste non contribuiscono alla quota, in particolare per l'accesso di base. Se la query è diversa e viene inviata insieme allo stesso token di pagina, viene restituito un errore.