Interfejs Google Ads API wymusza limity operacji API, np. liczbę operacji, które można wysłać w jednym żądaniu zmiany. W tabeli poniżej znajdziesz podsumowanie niektórych ważnych limitów i kwot, o których warto pamiętać.
| Typ żądania, ograniczenie i kod błędu | ||
|---|---|---|
| Operacje na poziomie dostępu Podstawowy | 15 000 operacji interfejsu API dziennie |
RESOURCE_EXHAUSTED
|
| Żądania zmiany | 10 000 operacji na żądanie |
TOO_MANY_MUTATE_OPERATIONS
|
| Żądania usługi planowania | 1 zapytanie/s |
RESOURCE_EXHAUSTED
|
| Żądania usługi przesyłania konwersji | 2000 konwersji na żądanie |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
| Prośby dotyczące usługi rozliczeń i budżetu konta | 1 operacja na żądanie zmiany |
TOO_MANY_MUTATE_OPERATIONS
|
Dzienne limity operacji interfejsu API
Dzienne limity wykorzystania interfejsu API zależą od liczby operacji interfejsu API wykonywanych na token dewelopera. Operacje API to łączna suma żądań pobierania i operacji modyfikacji. Limity dziennych operacji interfejsu API zależą od poziomu dostępu tokena dewelopera. W przewodniku po poziomach dostępu i dopuszczalnym użytkowaniu znajdziesz szczegółowe limity operacji interfejsu API dla każdego poziomu dostępu.
Żądania, które naruszają te limity, są odrzucane z błędem:RESOURCE_EXHAUSTED.
Ograniczenia gRPC
Wszystkie biblioteki klienta interfejsu Google Ads API używają gRPC do generowania żądań i odpowiedzi. Domyślnie gRPC ma rozmiar wiadomości 4 MB, ale nasze biblioteki klienta ustawiają maksymalny rozmiar wiadomości na 64 MB, aby zwiększyć wydajność.
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 64 MB. Aby uniknąć przekroczenia tego limitu, możesz zmniejszyć liczbę wybranych pól lub użyć strumieniowania. W przypadku operacji modyfikacji wysyłaj mniej operacji w każdym żądaniu.
Żądania, które naruszają to ograniczenie, nie wygenerują GoogleAdsError, ale wygenerują błąd gRPC 429 Resource Exhausted. Zapoznaj się z listą kodów błędów i komunikatów gRPC.
Żądania zmiany
Oprócz tego, że żądanie mutate jest wliczane do dziennego limitu operacji użytkownika,nie może ono zawierać więcej niż 10 tysięcy operacji.
Prośby, które naruszają to ograniczenie, są odrzucane z błędem:TOO_MANY_MUTATE_OPERATIONS.
Dodatkowe limity i uwagi dotyczące konkretnych usług i rodzajów żądań znajdziesz poniżej.
Wyszukaj żądania
Żądanie Search lub SearchStream jest liczone jako 1 operacja w ramach dziennego limitu operacji użytkownika. Jedno żądanie SearchStream jest traktowane jako jedna operacja interfejsu API, niezależnie od liczby partii.
Żą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 paginacji, które zawierają nieaktualny lub nieprawidłowy token strony, spowodują jednak wygenerowanie wyjątku i będą wliczane do dziennego limitu operacji.
Więcej informacji o stronicowaniu znajdziesz w artykule Przeglądanie wyników.
Inne typy próśb
Żądanie, które nie jest żądaniem Get, Mutate, Search ani SearchStream, jest liczone jako 1 operacja w ramach dziennego limitu operacji użytkownika.
Oto kilka przykładów takich próśb:
BatchJobService.ListMutateJobResultsConversionUploadService.UploadCallConversionsConversionUploadService.UploadClickConversionsOfflineUserDataJobService.AddOfflineUserDataJobOperationsOfflineUserDataJobService.CreateOfflineUserDataJobUserDataService.UploadUserData
Żądania, które zwracają wyjątki interfejsu API
Żądania odrzucone z kodem GoogleAdsFailure nadal wliczają się do dziennego limitu operacji użytkownika.
Żądania, które nie powiodły się, ale nie zwracają kodu GoogleAdsFailure, 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ć awaria połączenia sieciowego.
Usługa planowania słów kluczowych
Ze względu na koszty i złożoność poniższe metody usługi Planowanie słów kluczowych podlegają limitom odrębnym od innych typów żądań.
Ograniczenie do 1 żądania na sekundę na identyfikator klienta:
KeywordPlanIdeaService.GenerateKeywordIdeasKeywordPlanIdeaService.GenerateKeywordHistoricalMetricsKeywordPlanIdeaService.GenerateKeywordForecastMetrics
Żądania, które naruszają te ograniczenia, są odrzucane z błędem:
RESOURCE_EXHAUSTED.1 zapytanie na sekundę to 60 żądań na 60 sekund.
Ograniczenie do 2 żądań na sekundę na identyfikator klienta:
Podczas tworzenia planu słów kluczowych pamiętaj o tych limitach.
| Obiekt planu dotyczącego 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 statystyk odbiorców
Te metody w ramach metod AudienceInsightsService podlegają określonym limitom.
Ograniczenie do około 200 żądań dziennie na identyfikator klienta:
Ograniczenie do 2 żądań na sekundę na token dewelopera:
Usługa przesyłania konwersji
Ograniczenie do 2000 konwersji telefonicznych lub konwersji z kliknięcia na żądanie:
Żądania, które naruszają te limity, są odrzucane z błędem:
TOO_MANY_CONVERSIONS_IN_REQUEST.
Usługa przesyłania korekt konwersji
Limit 2000 dostosowań konwersji na żądanie:
Żądania, które naruszają te limity, są odrzucane z błędem:
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 pod kątem fakturowania miesięcznego.
Prośby, które naruszają to ograniczenie, są odrzucane z błędem:
MUTATE_NOT_ALLOWED.W przypadku żądań zmiany dozwolona jest tylko 1 operacja.
Prośby, które naruszają to ograniczenie, są odrzucane z błędem:
TOO_MANY_MUTATE_OPERATIONS.Między zmianami zamówienia budżetu na tym samym koncie powinno upłynąć co najmniej 12 godzin. Wprowadzanie zmian przed upływem 12 godzin może spowodować nieodwracalne błędy, które może rozwiązać tylko przedstawiciel konta Google Ads.
Zaproszenia do kont klientów
Nowych użytkowników można zapraszać na istniejące konta klientów za pomocą funkcji CustomerUserAccessService. Ta funkcja wysyła e-maile z zaproszeniem do innych użytkowników, więc może być nadużywana. Dlatego jej działanie jest ograniczone:
Użytkownicy nie mogą otrzymać więcej niż 1 oczekującego zaproszenia do tego samego konta klienta. Jeśli zostanie wysłana kolejna prośba o zaproszenie użytkownika, który ma już oczekujące zaproszenie, pojawi się ten błąd:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.Konta klientów nie mogą mieć więcej niż 70 oczekujących zaproszeń jednocześnie. Jeśli wyślesz żądanie, które spowoduje przekroczenie tej wartości, zwracany jest ten błąd:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.
Dane użytkownika
Danymi użytkowników zarządza się za pomocą UserDataService i OfflineUserDataJobService.
W ramach danej operacji tworzenia lub usuwania UserData każdy zestaw user_identifiers
powinien być przypisany do 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 występuje więcej niż 20 elementów user_identifiers.
Możesz użyć maksymalnie 100 000 identyfikatorów użytkownika niezależnie od liczby operacji.
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.
Jeśli napotkasz to ograniczenie i wysyłasz żądania, które używają pola powtarzanego, spróbuj zmniejszyć liczbę elementów w tym polu, wdrażając listę operacji w żądaniu zmiany.
Podczas wykonywania zapytania GAQL maksymalna liczba elementów w klauzuli IN wynosi 20 tys. Jeśli przekroczysz ten limit, zwracany jest błąd FILTER_HAS_TOO_MANY_VALUES.