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 nie wiąże się z żadnymi dodatkowymi opłatami.
Limity zapytań
Operacje związane z zapytaniami wykonywane za pomocą metod Search lub SearchStream mają zastosowanie do opisanych poniżej limitów.
- 3000 zapytań na minutę na projekt na użytkownika;
- 3000 zapytań na minutę na projekt
- 150 000 zapytań dziennie na projekt
Dzienne limity operacji interfejsu API
Dzienne limity wykorzystania interfejsu API są określane na podstawie liczby operacji interfejsu API wykonywanych na jednym projekcie Google Cloud.
Pojedyncze zapytanie lub raport jest liczone jako 1 operacja niezależnie od wyników przesyłanych strumieniowo przez usługę SearchAds360Service.SearchStream czy stron z wywołania SearchAds360Service.Search.
Więcej informacji
W tabeli poniżej znajdziesz kilka przykładów księgowości:
| Żądanie do interfejsu API | Operacje wliczane do limitu dziennego |
|---|---|
Operacja: Search
Liczba: 53 grupy reklam
Usługa: |
1 |
Operacja: SearchStream
Liczba: 45 kampanii
Usługa: |
1 |
Żądania, które naruszają te limity, są odrzucane z błędem: RESOURCE_EXHAUSTED.
Żądania wyszukiwania
Żądanie Search lub SearchStream jest liczone jako 1 operacja w dziennym limicie operacji użytkownika. Jedno żądanie SearchStream jest liczone jako 1 operacja interfejsu API niezależnie od liczby wsadów.
Ograniczenia gRPC
Wszystkie biblioteki klienta interfejsu Search Ads 360 Reporting API używają gRPC do generowania żądań i odpowiedzi. Domyślnie rozmiar komunikatu w gRPC wynosi 4 MB.
Liczba odpowiedzi nie może przekraczać tego limitu. Na przykład żądanie wyszukiwania, które obejmuje wiele pól, może spowodować wygenerowanie odpowiedzi o rozmiarze przekraczającym 4 MB. Aby uniknąć tego limitu, możesz zmniejszyć liczbę wybranych pól, zmniejszyć rozmiar strony lub użyć strumieniowego przesyłania danych.
Żą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 podzielone na strony (na przykład żądania zawierające prawidłowy atrybut next_page_token) nie są wliczane do dziennego limitu operacji użytkownika.
Jednak żądania podziału na strony, które zawierają wygasły lub nieprawidłowy token strony, spowodują wygenerowanie wyjątku i będą wliczane do dziennego limitu operacji.
Żądania podzielone na strony, np. żądania wyszukiwania, również podlegają ograniczeniom Page size cannot exceed 10,000 rows. Są one odrzucane, jeśli naruszają ten limit, z tym błędem: INVALID_PAGE_SIZE.
Więcej informacji o podziale na strony znajdziesz w tym artykule.
Żądania, które zwracają wyjątki dotyczące interfejsu API
Żądania odrzucone przy użyciu SearchAds360Failure nadal są wliczane do dziennego limitu operacji użytkownika.
Żą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ć awaria
połączenia sieciowego.
Inne typy limitów
Pole powtarzane (np. lista operacji), które ma zbyt wiele elementów w żądaniu, może spowodować błąd: REQUEST_SIZE_LIMIT_EXCEEDED.
Ten sam komunikat o błędzie może być 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, zwracany jest błąd FILTER_HAS_TOO_MANY_VALUES.