Interfejs Google Ads API egzekwuje ograniczenia operacji interfejsu API, takich jak liczba operacji, które można wysłać w jednym żądaniu zmiany. W tabeli poniżej znajdziesz podsumowanie niektórych ważnych limitów, o których musisz pamiętać.
Typ żądania, ograniczenie i kod błędu | |||
---|---|---|---|
Żądania z podziałem na strony | 10 000 wierszy na stronę, |
INVALID_PAGE_SIZE
|
|
Operacje z dostępem podstawowym | 15 000 operacji API dziennie |
RESOURCE_EXHAUSTED
|
|
Zmień żądania | 10 000 operacji na żądanie |
TOO_MANY_MUTATE_OPERATIONS
|
|
Prośby o usługę Planning | 1 zapytanie na sekundę |
RESOURCE_EXHAUSTED
|
|
Żądania usługi przesyłania konwersji | 2000 konwersji na żądanie |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
|
Prośby o usługę dotyczącą płatności i budżetu konta | 1 operacja na żądanie zmiany |
TOO_MANY_MUTATE_OPERATIONS
|
Dzienne limity operacji interfejsu API
Dzienne limity wykorzystania interfejsu API są obliczane na podstawie liczby operacji interfejsu API wykonanych na token programisty. Operacje API to łączna suma żądań get i operacji mutacji. Limity dziennych operacji przy użyciu interfejsu API zależą od poziomu dostępu do tokena programisty. W przewodniku po poziomach dostępu i dozwolonym użyciu opisano limity dotyczące operacji interfejsu API obowiązujące w przypadku poszczególnych poziomów dostępu.
Żądania, które naruszają te limity, są odrzucane z komunikatem o błędzie: RESOURCE_EXHAUSTED
.
Ograniczenia gRPC
Wszystkie biblioteki klienta interfejsu Google Ads API używają do generowania żądań i odpowiedzi gRPC. Domyślnie gRPC ma rozmiar wiadomości 4 MB, ale nasze biblioteki klienta ustawiły maksymalny rozmiar wiadomości na 64 MB, aby zwiększyć wydajność.
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 64 MB. Aby uniknąć tego limitu, możesz zmniejszyć liczbę wybranych pól, zmniejszyć rozmiar strony lub użyć strumieniowego przesyłania danych. W przypadku mutacji wysyłaj mniej operacji na żądanie.
Żądania, które naruszają to ograniczenie, nie wygenerują zdarzenia GoogleAdsError
, 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.
Zmień żądania
Oprócz wliczanego do dziennego limitu operacji użytkownika żądanie mutacji nie może zawierać więcej niż 10 000 operacji na żądanie.
Żądania, które naruszają to ograniczenie, są odrzucane z tym błędem: TOO_MANY_MUTATE_OPERATIONS
.
Poniżej przedstawiamy dodatkowe ograniczenia i uwagi dotyczące określonych usług i typów żądań.
Żą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.
Żą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.
Inne typy próśb
Żądanie, które nie jest żądaniem Get
, Mutate
, Search
ani SearchStream
, jest liczone jako jedna operacja w ramach dziennego limitu operacji użytkownika.
Oto kilka przykładów takich próśb:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
Żądania, które zwracają wyjątki od interfejsu API
Żądania odrzucone za pomocą GoogleAdsFailure
nadal są wliczane do dziennego limitu operacji użytkownika.
Żądania, które kończą się niepowodzeniem, ale nie zwracają GoogleAdsFailure
, 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.
Usługi planowania
Ze względu na koszty i złożoność opisane poniżej metody usługi Planning podlegają innym ograniczeniom niż inne typy żądań.
Ograniczenie do 1 żądania na sekundę na identyfikator klienta lub token programisty:
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
Żądania, które naruszają te ograniczenia, są odrzucane z komunikatem o błędzie:
RESOURCE_EXHAUSTED
.1 zapytanie na sekundę to 60 żądań na 60 sekund.
Pamiętaj o tych limitach podczas tworzenia planu słów kluczowych.
Obiekt planu słów kluczowych | Maksymalna liczba |
---|---|
KeywordPlan na konto |
10 000 |
KeywordPlanAdGroup na KeywordPlan |
200 |
KeywordPlanAdGroupKeyword na KeywordPlan |
10 000 |
KeywordPlanCampaignKeyword (wykluczające słowa kluczowe) |
1000 |
KeywordPlanCampaign na KeywordPlan |
1 |
Usługa przesyłania konwersji
Ograniczenie do 2000 konwersji telefonicznych lub po kliknięciu na żądanie:
Żądania, które naruszają te limity, są odrzucane z komunikatem o błędzie:
TOO_MANY_CONVERSIONS_IN_REQUEST
.
Usługa przesyłania korekty konwersji
Ograniczenie do 2000 dostosowań konwersji na żądanie:
Żądania, które naruszają te limity, są odrzucane z komunikatem o błędzie:
TOO_MANY_ADJUSTMENTS_IN_REQUEST
.
Usługi związane z płatnościami i budżetem konta
Zmiany można wprowadzać tylko na kontach skonfigurowanych do fakturowania miesięcznego.
Żądania, które naruszają to ograniczenie, są odrzucane z tym błędem:
MUTATE_NOT_ALLOWED
.W przypadku żądań zmiany dozwolona jest tylko 1 operacja.
Żądania, które naruszają to ograniczenie, są odrzucane z tym błędem:
TOO_MANY_MUTATE_OPERATIONS
.Między wprowadzeniem zmian w zamówieniu budżetowym na tym samym koncie należy odczekać co najmniej 12 godzin. Wprowadzenie zmian przed upływem 12 godzin może spowodować nieodwracalne błędy, które mogą rozwiązać tylko przedstawiciel ds. konta Google Ads.
Zaproszenia do kont klientów
Nowych użytkowników można zapraszać do istniejących kont klientów za pomocą CustomerUserAccessService
. Ta funkcja wysyła e-maile z zaproszeniami do innych użytkowników, więc może zostać niewłaściwie wykorzystywana. Obowiązują ograniczenia w tym działaniu:
Użytkownicy nie mogą otrzymać więcej niż 1 oczekującego zaproszenia na 1 konto klienta. W przypadku kolejnej prośby o wysłanie zaproszenia do użytkownika, który ma już oczekujące zaproszenie, zostanie zwrócony ten błąd:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION
.Konta klienta nie mogą mieć więcej niż 70 oczekujących zaproszeń naraz. Jeśli zostanie wysłane żądanie, które powoduje przekroczenie tej wartości, zostanie zwrócony ten błąd:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED
.
Dane użytkownika
Dane użytkownika są zarządzane za pomocą UserDataService
i OfflineUserDataJobService
.
W ramach danej operacji tworzenia/usuwania UserData
każdy zestaw elementów user_identifiers
powinien dotyczyć tylko jednego użytkownika.
Aby to wymusić, zwracany jest błąd OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
lub UserDataError.TOO_MANY_USER_IDENTIFIERS
, gdy w zbiorze UserData
jest więcej niż 20 user_identifiers
.
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.
Jeśli napotkasz to ograniczenie i wysyłasz żądania, które korzystają z pola powtarzanego, spróbuj zmniejszyć liczbę elementów w polu powtarzanym, wdrażając listę operacji w żądaniu mutacji.
Podczas tworzenia zapytania GAQL maksymalna liczba elementów w klauzuli IN
wynosi 20 000. Jeśli przekroczysz ten limit, zostanie zwrócony błąd FILTER_HAS_TOO_MANY_VALUES
.