Interfejs Search Ads 360 Reporting API narzuca limity operacji API, aby zapewnić optymalną wydajność systemu dla wszystkich użytkowników.
Ceny
Korzystanie z interfejsu Search Ads 360 Reporting API jest uwzględnione w ogólnych cenach Search Ads 360. Korzystanie z interfejsu API jest bezpłatne.
Limity zapytań
Operacje zapytań wykonywane za pomocą metod Search lub SearchStream są objęte tymi limitami.
- 3000 zapytań na minutę na projekt na użytkownika
- 3000 zapytań na minutę na projekt
- 150 tys. zapytań dziennie na projekt
Limity dzienne operacji interfejsu API
Dzienne limity korzystania z interfejsu API są określane na podstawie liczby operacji interfejsu API wykonanych w poszczególnych projektach Google Cloud.
Pojedyncze zapytanie lub raport jest liczone jako 1 operacja niezależnie od tego, czy wyniki są przesyłane strumieniowo za pomocą interfejsu SearchAds360Service.SearchStreamczy też są pobierane strona po stronie z poziomu wywołania SearchAds360Service.Search.
Więcej informacji
W tabeli poniżej znajdziesz kilka przykładów księgowania:
| Żądanie do interfejsu API | Operacje wliczane do limitu dziennego |
|---|---|
Operacja: Search
Liczba: 53 grup reklam
Usługa: |
1 |
Operacja: SearchStream
Liczba: 45 kampanii
Usługa: |
1 |
Żądania, które przekraczają te limity, są odrzucane z błędem RESOURCE_EXHAUSTED.
Żądania wyszukiwania
Żądanie Search lub SearchStream jest liczone jako 1 operacja w ramach dziennego limitu operacji użytkownika. Jedno żądanie SearchStream jest liczone jako 1 operacja interfejsu API niezależnie od liczby partii.
Ograniczenia gRPC
Wszystkie biblioteki klienta interfejsu Search Ads 360 Reporting API używają protokołu gRPC do generowania żądań i odpowiedzi. Domyślny rozmiar wiadomości gRPC to 4 MB.
Odpowiedzi nie mogą przekraczać tego limitu. Na przykład żądanie wyszukiwania zawierające wiele pól może wygenerować odpowiedź o rozmiarze przekraczającym 4 MB. Aby uniknąć tego limitu, możesz zmniejszyć liczbę wybranych pól, zmniejszyć rozmiar strony lub użyć strumieniowania.
Prośby, które naruszają to ograniczenie, nie wygenerują błędu SearchAds360Error, ale błąd429 Resource Exhausted gRPC. Zapoznaj się z listą kodów błędów i komunikatów gRPC.
Żądania po stronie
Żądania po stronie (np. żądania zawierające prawidłową wartośćnext_page_token) nie są wliczane do dziennego limitu operacji użytkownika.
Jednak w przypadku żądań pobierania stron zawierających nieprawidłowy lub wygasły token strony generowane są wyjątki, a żądania te są wliczane do dziennego limitu operacji.
Wymagania, które są podzielone na strony, takie jak wymagania dotyczące wyszukiwania, podlegają również ograniczeniu Page size cannot exceed 10,000 rows i są odrzucane, jeśli naruszają to ograniczenie. W takim przypadku wyświetlany jest błąd:
INVALID_PAGE_SIZE.
Więcej informacji o podziałach na strony znajdziesz w artykule Przeglądanie wyników na stronach.
Żądania z wyjątkami interfejsu API
Żądania odrzucone z powodu błędu SearchAds360Failure są nadal uwzględniane w liczbie operacji dozwolonych na użytkownika w ciągu dnia.
Żądania, które nie powiodły się, ale nie zwracająSearchAds360Failure, np. z powodu błędu na poziomie sieci, nie będą wliczane do dziennej kwoty operacji użytkownika, ponieważ żądania nigdy nie dotrą do usługi. Przykładem może być utrata połączenia z siecią.
Inne typy limitów
Pole powtarzane, np. lista operacji, które zawiera zbyt wiele elementów w żądaniu, może spowodować błąd:
REQUEST_SIZE_LIMIT_EXCEEDED.
Ten sam komunikat o błędzie może być też spowodowany innymi problemami.
W zapytaniu w języku zapytań Search Ads 360 maksymalna liczba elementów w nawiasach klamrowych IN wynosi 20 tys. Jeśli przekroczysz ten limit, zwrócony zostanie błąd FILTER_HAS_TOO_MANY_VALUES.