Możesz przeglądać wyniki pobrane za pomocą GoogleAdsService.Search, zamiast pobierać cały zestaw wyników naraz. Omówienie raportowania za pomocą interfejsu Google Ads API znajdziesz w artykule na ten temat.
Search zwraca stałe strony zawierające maksymalnie 10 tys. wierszy. Ustawienie page_size w SearchGoogleAdsRequest jest wycofane i zwraca błąd RequestError.PAGE_SIZE_NOT_SUPPORTED.
Przykładowe zapytanie i podział na strony
Rozważmy to zapytanie:
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 000 słów kluczowych, zestaw wyników będzie zawierać 10 000 obiektów GoogleAdsRow w pierwszej odpowiedzi wraz z next_page_token.
Aby pobrać kolejne 10 tys. wierszy, wyślij żądanie ponownie, ale zaktualizuj parametr page_token żądania do wartości next_page_token odpowiedzi:
{
"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",
"pageToken": "CN3q9...example_token..."
}
Pamiętaj, że pole next_page_token nie jest wypełniane w odpowiedzi zawierającej ostatnią partię wierszy.
Nasze biblioteki klienta automatycznie obsługują stronicowanie. Wystarczy, że przejrzysz wiersze odpowiedzi. Gdy zostaną zwrócone wszystkie wiersze na bieżącej stronie, biblioteka klienta automatycznie pobierze nową stronę wierszy, dopóki nie zostanie pobrany cały zbiór danych. Jeśli zamiast gRPC używasz REST, musisz wysłać żądanie dla każdej nowej strony.
Pamięć podręczna i wygaśnięcie tokena strony
Interfejs Google Ads API wewnętrznie przechowuje zbiór danych w pamięci podręcznej, dzięki czemu kolejne żądania stron są szybsze niż początkowe. Pamiętaj, że wartości next_page_token mają ograniczony czas życia (TTL) i wygasają, jeśli nie zostaną użyte w krótkim czasie (około 2 godzin). Jeśli token strony wygaśnie, interfejs API zwróci błąd i musisz rozpocząć nowe zapytanie.
Aby korzystać z danych z pamięci podręcznej, zapytanie musi pozostać identyczne w kolejnych żądaniach. Kolejne żądania stron nie są wliczane jako dodatkowe operacje do dziennego limitu operacji w przypadku dostępu eksploratora i dostępu podstawowego. Jeśli zapytanie jest inne i zostanie wysłane z tym samym tokenem strony, zwrócony zostanie błąd.