Wyniki pobrane za pomocą GoogleAdsService.Search
możesz wyświetlać na stronach, zamiast pobierać od razu cały zestaw wyników. Omówienie
raportowania za pomocą interfejsu Google Ads API znajdziesz w
przewodniku po raportowaniu.
Wyniki są zwracane na stronach zawierających maksymalnie 10 tys. wierszy. Jeśli w żądaniu nie ustawisz parametru page_size, domyślnie będzie on miał wartość 10 tys. Jeśli page_size ma wartość większą niż 10 tys., nadal będzie używana wartość 10 tys.
Na przykład:
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 tys. słów kluczowych, pierwszy zestaw wyników będzie zawierać 10 tys.
GoogleAdsRow obiektów oraz
next_page_token.
Aby pobrać kolejne 10 tys. wierszy, ponownie wyślij żądanie, ale zaktualizuj
żądania page_token na next_page_token w odpowiedzi. Pamiętaj, że
next_page_token nie jest wypełniany w odpowiedzi zawierającej
ostatnią partię wierszy.
Nasze biblioteki klienta automatycznie obsługują stronicowanie. Musisz tylko iterować po wierszach odpowiedzi. Gdy zostaną zwrócone wszystkie wiersze na bieżącej stronie, biblioteka klienta automatycznie pobierze nową stronę wierszy, aż do pobrania całego zbioru danych. Jeśli zamiast gRPC używasz REST, musisz wyraźnie wysłać żądanie każdej nowej strony.
Interfejs Google Ads API wewnętrznie buforuje cały zbiór danych, więc kolejne żądania są szybsze niż pierwsze.
Aby korzystać z danych w pamięci podręcznej, zapytanie w kolejnych żądaniach musi pozostać dokładnie takie samo. Żądania nie będą wliczać się do limitu, zwłaszcza w przypadku dostępu na poziomie eksploratora i dostępu podstawowego. Jeśli zapytanie jest inne i zostanie wysłane z tym samym tokenem strony, zostanie zwrócony błąd.