Interfejs Search Ads 360 Reporting API wymusza limity operacji w interfejsie 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
Dzienne limity 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 są zliczane jako 1 operacja niezależnie od tego, czy wyniki są przesyłane strumieniowo za pomocą interfejsu SearchAds360Service.SearchStreamczy też po stronie klienta 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 większym rozmiarze niż 4 MB. Aby uniknąć tego limitu, możesz zmniejszyć liczbę wybranych pól, zmniejszyć rozmiar strony lub użyć strumieniowania.
Żądania, które naruszają to ograniczenie, nie generują SearchAds360Error, ale błąd gRPC 429 Resource Exhausted. Zapoznaj się z listą kodów błędów i komunikatów gRPC.
Żądania z podziałem na strony
Żądania pogrupowane (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ą uwzględniane w liczbie operacji dozwolonych w ramach dziennego limitu.
Wymagania, które są podzielone na strony, takie jak wyszukiwania, są również objęte ograniczeniem Page size cannot exceed 10,000 rows i są odrzucane, jeśli przekraczają ten limit. W takim przypadku pojawia się 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, które zostały odrzucone z powodu błędu SearchAds360Failure, nadal są uwzględniane w liczbie operacji dozwolonych na użytkownika w ciągu dnia.
Żądania, które kończą się niepowodzeniem, ale nie zwracają SearchAds360Failure, na przykład w wyniku błędu na poziomie sieci, nie są wliczane do dziennego limitu operacji użytkownika, ponieważ takie żą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.
Podczas tworzenia zapytania w języku zapytań Search Ads 360 w klauzuli IN maksymalna liczba elementów to 20 000. Jeśli przekroczysz ten limit, zwrócony zostanie błąd FILTER_HAS_TOO_MANY_VALUES.