Aby pobrać elementy i dane raportowania interfejsu Google Ads API, możesz użyć jednej z tych metod:
Oto ogólne różnice między nimi:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Można użyć kodu produkcyjnego | Yes | Yes |
| Usługa | GoogleAdsService |
GoogleAdsService |
| Scenariusz | Pobieram obiekty i raporty | Pobieram obiekty i raporty |
| Odpowiedź | Strumień obiektów GoogleAdsRow |
Strony obiektów GoogleAdsRow |
| Pola odpowiedzi | Tylko te określone w zapytaniu | Tylko te określone w zapytaniu |
| Limity dzienne | Limity dzienne oparte na poziomach dostępu | Limity dzienne oparte na poziomach dostępu |
SearchStream a sieć wyszukiwania
Search może wysyłać żądania pobrania całego raportu podzielone na strony, natomiast SearchStream wysyła jedno żądanie i inicjuje trwałe połączenie z interfejsem Google Ads API niezależnie od rozmiaru raportu.
W przypadku SearchStream pobieranie pakietów danych rozpoczyna się natychmiast, a cały wynik jest zapisywany w buforze danych. Twój kod może zacząć odczytywać dane zbuforowane bez konieczności czekania na zakończenie całej transmisji.
Wyeliminując czas przesyłania danych w obie strony wymagany do żądania każdej strony w odpowiedzi Search (w zależności od aplikacji), SearchStream może zapewnić lepszą wydajność względem stronicowania, zwłaszcza w przypadku większych raportów.
Przykład
Utwórz np. raport, który składa się z 100,000 wierszy. W tabeli poniżej znajdziesz zestawienie różnic w rozliczeniu 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 SearchStream zamiast Search z tych powodów:
Raporty obejmujące jedną stronę (poniżej 10 000 wierszy): brak istotnych różnic w skuteczności między tymi metodami.
W przypadku raportów obejmujących wiele stron:
SearchStreamdziała zwykle szybciej, ponieważ unika się wielokrotnych transferów danych w obie strony, a odczyt lub zapis z pamięci podręcznej dysku jest mniejszy.
Ograniczenia liczby żądań
Limity dzienne dla obu metod są zgodne ze standardowymi limitami i poziomami dostępu związanymi z tokenem programisty. Pojedyncze zapytanie lub raport jest liczone jako jedna operacja niezależnie od tego, czy wyniki są stronowane czy przesyłane strumieniowo.