Podział wyników na strony

GoogleAdsService.Search obsługuje stronicowanie przy stałym rozmiarze stron do 10 000 wierszy. Zbiór wyników zapytania jest podzielony w wielu odpowiedziach, z których każda zawiera 10 tys. obiektów.

Na przykład dla 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 konto zawiera 50 000 słów kluczowych, zestaw wyników będzie zawierał 10 000 słów kluczowych. GoogleAdsRow obiektów w pierwszej odpowiedzi, oraz next_page_token.

Aby pobrać następne 10 000 wierszy, wyślij żądanie ponownie, ale zaktualizuj odpowiednio identyfikator page_token żądania do odpowiedzi next_page_token Pamiętaj, że next_page_token nie jest wypełniane w odpowiedzi zawierającej ostatnią grupę wierszy.

Nasze biblioteki klienta obsługują stronicowanie automatycznie. Wystarczy, że będziesz iterować w wierszach odpowiedzi. Gdy wszystkie wiersze na bieżącej stronie zawierają zostanie zwrócony, biblioteka klienta automatycznie pobiera nową stronę wierszy w Twoim imieniu do momentu pobrania całego zbioru danych. Jeśli zamiast tego używasz REST gRPC, musisz jawnie wysyłać żądanie do każdej nowej strony.

Interfejs Google Ads API zapisuje cały zbiór danych w pamięci podręcznej, dzięki czemu kolejne żądania są szybciej niż początkowa.

Aby skorzystać z możliwości, Twoje zapytanie musi pozostać dokładnie takie samo w kolejnych żądaniach. danych w pamięci podręcznej, żądania nie wliczają się do limitu, zwłaszcza w przypadku podstawowego dostępu. Jeśli różni się i zostanie wysłane wraz z tym samym tokenem strony, zwracany jest błąd.