Interfejs Search Ads 360 Reporting API nakłada limity na operacje 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. Za korzystanie z interfejsu API nie są pobierane żadne dodatkowe opłaty.
Limity zapytań
W przypadku operacji zapytań wykonywanych za pomocą metod Search lub SearchStream obowiązują te limity:
- 3000 zapytań na minutę na projekt na użytkownika,
- 3000 zapytań na minutę na projekt,
- 150 tys. zapytań dziennie na projekt.
Dzienne limity operacji API
Dzienne limity korzystania z interfejsu API są oparte na liczbie operacji API wykonywanych w ramach projektu Google Cloud.
Pojedyncze zapytanie lub raport jest liczony jako 1 operacja niezależnie od tego, czy wyniki
są przesyłane strumieniowo za pomocą
SearchAds360Service.SearchStream
czy też stronicowane za pomocą wywołania
SearchAds360Service.Search. Więcej informacji.
W tabeli poniżej znajdziesz kilka przykładów rozliczeń:
| Żądanie do interfejsu API | Operacje wliczane do limitu dziennego |
|---|---|
Operacja: Search
Liczba: 53 grupy reklam Usługa: SearchAds360Service
|
1 |
Operacja: SearchStream
Liczba: 45 kampanii Usługa: SearchAds360Service
|
1 |
Żądania, które naruszają te limity, są odrzucane z błędem:
RESOURCE_EXHAUSTED.
Wyszukaj żądania
Żądanie Search lub SearchStream jest liczone jako 1 operacja w ramach dziennego limitu operacji użytkownika. Żądanie SearchStream jest liczone jako 1 operacja API niezależnie od liczby partii.
Ograniczenia gRPC
Wszystkie biblioteki klientów interfejsu Search Ads 360 Reporting API używają gRPC do generowania żądań i odpowiedzi. Domyślnie gRPC ma rozmiar wiadomości 4 MB.
Odpowiedzi nie mogą przekraczać tego limitu. Na przykład żądanie wyszukiwania, które zawiera 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ć przesyłania strumieniowego.
Żądania, które naruszają to ograniczenie, nie wygenerują
SearchAds360Error,
ale wygenerują błąd gRPC 429 Resource Exhausted. Zapoznaj się z
listą kodów i komunikatów o błędach gRPC.
Żądania stronicowane
Żądania stronicowane (np. żądania zawierające prawidłowy token next_page_token) nie są wliczane do dziennego limitu operacji użytkownika.
Żądania stronicowania, które zawierają nieprawidłowy lub nieaktualny token strony, spowodują jednak wyjątek i będą wliczane do dziennego limitu operacji.
Żądania, które są stronicowane, np. żądania wyszukiwania, podlegają też ograniczeniu
Page size cannot exceed 10,000 rows i są odrzucane, jeśli naruszają
ten limit, z błędem:
INVALID_PAGE_SIZE.
Więcej informacji o stronicowaniu znajdziesz w artykule Stronicowanie wyników.
Żądania, które zwracają wyjątki interfejsu API
Żądania odrzucone z powodu a
SearchAds360Failure
nadal są wliczane do dziennego limitu operacji użytkownika.
Żądania, które nie powiodły się, ale nie zwracają błędu
SearchAds360Failure,
np. z powodu błędu na poziomie sieci, nie będą wliczane do dziennego
limitu operacji użytkownika, ponieważ żądania nigdy nie dotrą do usługi. Przykładem jest brak połączenia z siecią.
Inne rodzaje 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.
Podczas wykonywania zapytania w języku zapytań Search Ads 360,
maksymalna liczba elementów w klauzuli IN wynosi 20 tys. Jeśli przekroczysz ten
limit, zostanie zwrócony
FILTER_HAS_TOO_MANY_VALUES
błąd.