GoogleAdsService.Search supporta
il paging specificando
page_size nella richiesta.
Questo suddivide il set di risultati della query in più risposte, ciascuna delle quali
contiene fino a page_size
numero di oggetti. Se
page_size non è specificato,
viene impostato automaticamente il massimo di 10.000 righe.
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 il tuo account contiene 50.000 parole chiave e page_size è impostato su 1,000, l'insieme di risultati conterrà 1000 oggetti GoogleAdsRow nella prima risposta, insieme a un elemento 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 con il 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 automaticamente il paging. Devi solo ripetere l'iterazione delle righe della risposta. Quando vengono restituite tutte le righe della pagina corrente, la libreria client recupera automaticamente una nuova pagina di righe per tuo conto fino al recupero dell'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 sono più veloci di quelle iniziali. A seconda del caso d'uso, puoi impostare page_size su qualsiasi valore compreso tra 1 e 10.000. In generale, per prestazioni complessive più rapide, utilizza una page_size più grande per meno passaggi di andata e ritorno.
La 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.