Interfejs Search Ads 360 Reporting API egzekwuje ograniczenia działań interfejsu 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ólnej cenie usługi Search Ads 360. Korzystanie z interfejsu API nie wiąże się z dodatkowymi opłatami.
Limity zapytań
Podane niżej limity dotyczą operacji na zapytaniach wykonywanych za pomocą metod Search lub SearchStream.
- 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 opierają się na liczbie operacji API wykonanych w projekcie Google Cloud.
Pojedyncze zapytanie lub raport są liczone jako 1 operacja niezależnie od tego, czy wyniki są przesyłane strumieniowo przez metodę SearchAds360Service.SearchStream
czy też strona z wywołania SearchAds360Service.Search
.
Więcej informacji
Poniższa tabela zawiera 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 komunikatem o błędzie: RESOURCE_EXHAUSTED
.
Żądania wyszukiwania
Żądanie Search
lub SearchStream
jest liczone jako 1 operacja w ramach dziennego limitu operacji użytkownika. Jedno żądanie SearchStream
liczy się jako 1 operacja interfejsu API niezależnie od liczby wsadów.
Ograniczenia gRPC
Wszystkie biblioteki klienta interfejsu Search Ads 360 Reporting API do generowania żądań i odpowiedzi używają gRPC. Domyślnie rozmiar wiadomości w gRPC ma wartość 4 MB.
Liczba odpowiedzi nie może przekraczać tego limitu. Na przykład: wyszukiwanie obejmują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ć strumieniowego przesyłania danych.
Żądania, które naruszają to ograniczenie, nie wygenerują zdarzenia SearchAds360Error
, ale wywołają 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 element 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, będą generować wyjątek i będą wliczane do dziennego limitu operacji.
Żądania podzielone na strony, takie jak żądania wyszukiwania, również podlegają ograniczeniu Page size cannot exceed 10,000 rows
i są odrzucane, jeśli naruszają ten limit, z komunikatem o błędzie: INVALID_PAGE_SIZE
.
Więcej informacji o podziale wyników na strony znajdziesz w artykule Podział wyników na strony.
Żądania, które zwracają wyjątki od interfejsu API
Żądania odrzucone za pomocą SearchAds360Failure
nadal są wliczane do dziennego limitu operacji użytkownika.
Żądania, które kończą się niepowodzeniem, ale nie zwracają SearchAds360Failure
, np. z powodu błędu na poziomie sieci, nie są wliczane do dziennego limitu operacji użytkownika, ponieważ nie dotarłyby do usługi. Przykładem może być błąd połączenia sieciowego.
Inne typy limitów
Pole powtarzane, na przykład 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 wynikać z innych problemów.
Gdy tworzysz zapytanie w języku zapytań Search Ads 360, maksymalna liczba elementów w klauzuli IN
to 20 000. Jeśli przekroczysz ten limit, zostanie zwrócony błąd FILTER_HAS_TOO_MANY_VALUES
.