GoogleAdsService.Search obsługuje przewijanie w ramach stałego rozmiaru strony 10 tys. 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 parametr next_page_tokennie jest wypełniany w odpowiedzi zawierającej ostatnią partię wierszy.
Nasze biblioteki klienta obsługują automatycznie przewijanie. Wystarczy, że przejdziesz przez wiersze odpowiedzi. Gdy zwrócone zostaną 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 danych w pamięci podręcznej, zapytanie musi być dokładnie takie samo w kolejnych żądaniach. Te żądania nie będą wliczane do limitu, 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.