Aby pobrać encje interfejsu Google Ads API i dane do raportu, użyj jednej z tych metod:
Oto najważniejsze różnice między tymi 2 metodami:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Nadaje się do kodu produkcyjnego | Tak | Tak |
| Usługa | GoogleAdsService |
GoogleAdsService |
| Scenariusz | Pobieranie obiektów i raportów | Pobieranie obiektów i raportów |
| Odpowiedź | Strumień obiektów GoogleAdsRow |
Strony obiektów GoogleAdsRow |
| Pola odpowiedzi | Tylko te, które zostały określone w zapytaniu | Tylko te, które zostały określone w zapytaniu |
| Limity dzienne | Limity dzienne oparte na poziomach dostępu | Limity dzienne oparte na poziomach dostępu |
SearchStream a Search
Metoda Search może wysyłać wiele
żądań podzielonych na strony, aby pobrać cały raport, natomiast metoda SearchStream wysyła jedno żądanie i
inicjuje trwałe połączenie z interfejsem Google Ads API niezależnie od rozmiaru raportu.
W przypadku metody SearchStream pakiety danych zaczynają się pobierać natychmiast, a cały wynik jest buforowany w buforze danych. Kod może zacząć odczytywać dane z bufora bez konieczności czekania na zakończenie całego strumienia.
Dzięki wyeliminowaniu czasu potrzebnego na wysłanie żądania i otrzymanie odpowiedzi w sieci, który jest wymagany do pobrania każdej pojedynczej
strony odpowiedzi Search, w zależności od aplikacji, SearchStream może oferować
lepszą wydajność niż paginowanie, zwłaszcza w przypadku większych raportów.
Przykład
Ten przykład dotyczy raportu składającego się z 100,000 wierszy. W tabeli poniżej przedstawiono różnice w rozliczeniach między tymi 2 metodami.
| SearchStream | Szukaj | |
|---|---|---|
| Rozmiar strony | Nie dotyczy | 10 000 wierszy na stronę |
| Liczba żądań do interfejsu API | 1 żądanie | 10 żądań |
| Liczba odpowiedzi interfejsu API | 1 ciągły strumień | 10 odpowiedzi |
Czynniki wpływające na wydajność
W większości przypadków zalecamy używanie metody SearchStream zamiast Search z tych
powodów:
W przypadku raportów jednostronicowych (poniżej 10 000 wierszy): nie ma znaczących różnic w wydajności między tymi 2 metodami.
W przypadku raportów wielostronicowych: metoda
SearchStreamjest zwykle szybsza, ponieważ unika się wielu podróży w obie strony, a odczytywanie i zapisywanie w pamięci podręcznej dysku ma mniejsze znaczenie.
Ograniczenia liczby żądań
Limity dzienne w przypadku obu metod są zgodne ze standardowymi limitami i poziomami dostępu tokena programisty. Pojedyncze zapytanie lub raport jest liczony jako 1 operacja niezależnie od tego, czy wynik jest podzielony na strony, czy przesyłany strumieniowo.