GoogleAdsService.Search obsługuje przewijanie w ramach stałych rozmiarów stron 10 000 wierszy. Zbiór wyników zapytania jest podzielony na wiele odpowiedzi, z których każda zawiera 10 tys. obiektów.
Na przykład w przypadku tego zapytania:
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
Jeśli Twoje konto zawiera 50 tysięcy słów kluczowych, zbiór wyników będzie zawierać 10 tysięcy obiektów GoogleAdsRow w pierwszym odpowiedzi, a także next_page_token.
Aby pobrać kolejne 10 tys. wierszy, ponownie wyślij żądanie, ale zaktualizuj parametr page_token w prośbie na next_page_token w odpowiedzi.
Pamiętaj, że w odpowiedzi zawierającej ostatnią partię wierszy nie jest wypełniany parametr next_page_token.
Nasze biblioteki klienta obsługują automatycznie przewijanie. Wystarczy, że przejdziesz przez wiersze odpowiedzi. Gdy zwrócone zostaną już wszystkie wiersze na bieżącej stronie, biblioteka klienta automatycznie pobiera nową stronę wierszy w Twoim imieniu, aż do momentu pobrania całego zbioru danych. Jeśli zamiast gRPC używasz interfejsu REST, musisz wyraźnie wysyłać żądanie dotyczące każdej nowej strony.
Interfejs Google Ads API przechowuje w pamięci podręcznej cały zbiór danych, dzięki czemu kolejne żądania są szybsze niż pierwsze.
Aby korzystać z zawartych w pamięci podręcznej danych, w kolejnych żądaniach musisz używać dokładnie tego samego zapytania. Te żądania nie będą wliczać się do Twojej puli, zwłaszcza w przypadku dostępu podstawowego. Jeśli zapytanie różni się od poprzedniego, ale jest wysyłane z tym samym tokenem strony, zwracany jest błąd.