Aby pobrać jednostki interfejsu Google Ads API i dane raportowania, użyj jednej z tych metod:
Oto główne różnice między tymi 2 metodami:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Odpowiednie do kodu produkcyjnego | Tak | Tak |
| Usługa | GoogleAdsService |
GoogleAdsService |
| Scenariusz | Pobieranie obiektów i raportów | Pobieranie obiektów i raportów |
| Odpowiedź | Strumień GoogleAdsRow obiektów |
Strony z GoogleAdsRow obiektami |
| 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 na podstawie poziomów dostępu | Limity dzienne na podstawie poziomów dostępu |
SearchStream a Search
Search może wysyłać wiele żądań podzielonych na strony, aby pobrać cały raport, natomiast SearchStream wysyła jedno żądanie i nawiązuje trwałe połączenie z interfejsem Google Ads API niezależnie od rozmiaru raportu.
W przypadku SearchStream pakiety danych zaczynają się pobierać natychmiast, a cały wynik jest buforowany w buforze danych. Twój kod może zacząć odczytywać dane z bufora bez konieczności czekania na zakończenie całego strumienia.
Eliminując czas potrzebny na wysłanie żądania każdej strony odpowiedzi Search, w zależności od aplikacji SearchStream może zapewnić lepszą wydajność niż stronicowanie, zwłaszcza w przypadku większych raportów.
Przykład
W tym przykładzie analizujemy raport składający się z 100,000 wierszy. W tabeli poniżej znajdziesz zestawienie różnic w księgowaniu między tymi 2 metodami.
| SearchStream | Szukaj | |
|---|---|---|
| Rozmiar strony | Nie dotyczy | 10 000 wierszy na stronę |
| Liczba żądań do interfejsu API | 1 żądanie | 10 zgłoszeń |
| Liczba odpowiedzi interfejsu API | 1 ciągły strumień | 10 odpowiedzi |
Czynniki wpływające na skuteczność
W większości przypadków zalecamy używanie atrybutu SearchStream zamiast Search z tych powodów:
W przypadku raportów jednostronicowych (poniżej 10 000 wierszy): brak istotnych różnic w skuteczności między tymi 2 metodami.
W przypadku raportów wielostronicowych:
SearchStreamjest zwykle szybsze, ponieważ pozwala uniknąć wielu podróży w obie strony, a odczyt lub zapis z 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 dewelopera. Pojedyncze zapytanie lub raport jest traktowany jako 1 operacja niezależnie od tego, czy wynik jest podzielony na strony czy przesyłany strumieniowo.