Interfejs Search Ads 360 Reporting API wymusza 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 nie wiąże się z żadnymi dodatkowymi opłatami.
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 interfejsu API
Dzienne limity wykorzystania interfejsu API zależą od liczby operacji interfejsu API wykonanych w ramach projektu Google Cloud.
Pojedyncze zapytanie lub raport jest traktowany jako 1 operacja, niezależnie od tego, czy wyniki są przesyłane strumieniowo przez SearchAds360Service.SearchStream czy stronicowane w ramach wywołania SearchAds360Service.Search. Więcej informacji
W tabeli poniżej znajdziesz przykłady księgowania:
| Żą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. Jedno żądanie SearchStream jest liczone jako jedna operacja interfejsu API, niezależnie od liczby partii.
Ograniczenia gRPC
Wszystkie biblioteki klienta 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ąć przekroczenia tego limitu, możesz zmniejszyć liczbę wybranych pól, zmniejszyć rozmiar strony lub użyć strumieniowania.
Żądania, które naruszają to ograniczenie, nie wygenerują błędu SearchAds360Error, ale wygenerują błąd gRPC 429 Resource Exhausted. Zapoznaj się z listą kodów błędów i komunikatów o błędach gRPC.
Żądania z podziałem na strony
Żądania podzielone na strony (np. żądania zawierające prawidłowy parametr
next_page_token) nie są wliczane do dziennego limitu operacji użytkownika.
Żądania podziału na strony, które zawierają nieaktualny lub nieprawidłowy token strony, będą jednak generować wyjątek i będą wliczane do dziennego limitu operacji.
Żądania, które są podzielone na strony, np. żądania wyszukiwania, również podlegają ograniczeniu Page size cannot exceed 10,000 rows i są odrzucane, jeśli je naruszają. W takim przypadku zwracany jest błąd: INVALID_PAGE_SIZE.
Więcej informacji o stronicowaniu znajdziesz w artykule Przeglądanie wyników.
Żądania, które zwracają wyjątki interfejsu API
Żądania odrzucone z kodem błędu
SearchAds360Failure
są nadal wliczane do dziennego limitu operacji użytkownika.
Żądania, które nie powiodły się, ale nie zwracają kodu SearchAds360Failure, np. z powodu błędu na poziomie sieci, nie będą wliczane do dziennego limitu operacji użytkownika, ponieważ nigdy nie dotrą do usługi. Przykładem może być 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 000. Jeśli przekroczysz ten limit, zwracany jest błąd FILTER_HAS_TOO_MANY_VALUES.