GoogleAdsService.Search supporta il paging specificando page_size nella richiesta.
In questo modo il set di risultati della query viene suddiviso in più risposte, ognuna delle quali contiene un numero massimo di oggetti pari a page_size. Se
page_size non è specificato,
viene impostato automaticamente al massimo di 10.000 righe.
Ad esempio, per la query seguente:
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 e page_size è impostato su 1,000, il set di risultati conterrà 1000 oggetti GoogleAdsRow nella prima risposta, insieme a un next_page_token.
Per recuperare le successive mille righe, invia di nuovo la richiesta con le stesse dimensioni della pagina, ma aggiorna il valore page_token della richiesta impostandolo sul valore next_page_token della risposta. Il valore di page_size nelle richieste successive può essere diverso ogni volta. Tieni presente che next_page_token non viene compilato nella risposta che contiene l'ultimo batch di righe.
Le nostre librerie client gestiscono il paging automaticamente. Devi ripetere l'iterazione solo nelle 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 una richiesta esplicitamente per ogni nuova pagina.
L'API Google Ads memorizza internamente nella cache l'intero set di dati, in modo che le richieste successive siano più veloci della prima. A seconda del tuo caso d'uso, puoi impostare page_size su qualsiasi valore compreso tra 1 e 10.000. In generale, per un rendimento complessivo più rapido, utilizza un elemento page_size più grande per meno viaggi di andata e ritorno.
La tua query deve rimanere esattamente la stessa nelle richieste successive per sfruttare i dati memorizzati nella cache; le richieste non contribuiranno alla tua 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.