Aby pobrać elementy interfejsu Google Ads API i dane raportowania, możesz użyć jednej z tych metod:
Oto ogólne różnice między tymi metodami:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Odpowiedni dla kodu produkcyjnego. | Tak | Tak |
| Usługa | GoogleAdsService |
GoogleAdsService |
| Scenariusz | Pobieranie obiektów i raportów | Pobieranie obiektów i raportów |
| Odpowiedź | Strumień z GoogleAdsRow obiektów |
Strony z GoogleAdsRow obiektami |
| Pola odpowiedzi | Tylko te określone w zapytaniu | Tylko te określone w zapytaniu |
| Limity dzienne | Limity dzienne zależne od poziomów dostępu | Limity dzienne zależne od poziomów dostępu |
SearchStream a wyszukiwarka
Search może wysyłać wiele żądań z podziałem na strony, aby pobrać cały raport, ale SearchStream wysyła jedno żądanie i inicjuje trwałe połączenie z interfejsem Google Ads API niezależnie od rozmiaru raportu.
W przypadku urządzenia SearchStream pobieranie pakietów danych rozpoczyna się natychmiast, a cały wynik jest buforowany w buforze danych. Twój kod może zacząć odczytywać zbuforowane dane bez konieczności czekania na zakończenie całego strumienia.
Dzięki wyeliminowaniu czasu przesyłania żądań w obie strony w obie strony w odpowiedzi na żądania poszczególnych stron w odpowiedzi Search (w zależności od aplikacji) SearchStream może przynieść większą wydajność w porównaniu z stronicowaniem, zwłaszcza w przypadku większych raportów.
Przykład
Weź np. raport, który składa się z 100,000 wierszy. W tabeli poniżej przedstawiamy różnice księgowe między tymi metodami.
| SearchStream | Wyszukiwarka | |
|---|---|---|
| Rozmiar strony | Nie dotyczy | 10 000 wierszy na stronę |
| Liczba żądań do interfejsu API | 1 żądanie | 10 próśb |
| Liczba odpowiedzi interfejsu API | 1 ciągły strumień | 10 odpowiedzi |
Czynniki wydajności
W większości przypadków zalecamy użycie zamiast Search parametru SearchStream z tych powodów:
W przypadku raportów jednostronicowych (poniżej 10 000 wierszy): brak istotnych różnic pod względem skuteczności między obiema metodami.
W przypadku raportów na wielu stronach:
SearchStreamjest zwykle szybszy, ponieważ unika wielu podróży w obie strony, a odczyt i zapis z pamięci podręcznej dysku jest mniej istotne.
Ograniczenia liczby żądań
Limity dzienne dla obu metod są zgodne ze standardowymi limitami i poziomami dostępu tokena programisty. Pojedyncze zapytanie lub raport jest liczone jako 1 operacja niezależnie od tego, czy wynik jest wyświetlany na stronie czy przesyłany strumieniowo.