Interfejs Google Ads API narzuca limity operacji API, np. liczby operacji, które można wysłać w pojedynczym żądaniu zmiany. W tabeli poniżej znajdziesz najważniejsze limity i kwoty, o których warto pamiętać.
| Typ żądania, ograniczenie i kod błędu | ||
|---|---|---|
| Operacje z dostępem podstawowym | 15 tys. operacji interfejsu API dziennie |
RESOURCE_EXHAUSTED
|
| Zmiana żądań | 10 000 operacji na żądanie |
TOO_MANY_MUTATE_OPERATIONS
|
| Prośby o planowanie | 1 zapytanie/s |
RESOURCE_EXHAUSTED
|
| Prośby o usługę przesyłania konwersji | 2000 konwersji na żądanie |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
| Prośby dotyczące usługi Rozliczenia i budżet konta | 1 operacja na żądanie zmiany |
TOO_MANY_MUTATE_OPERATIONS
|
Limity dzienne operacji interfejsu API
Limity dziennego wykorzystania interfejsu API są określane na podstawie liczby operacji interfejsu API wykonanych za pomocą tokena dewelopera. Operacje interfejsu API to łączna suma żądań GET i operacji mutacji. Limity dziennych operacji interfejsu API zależą od poziomu dostępu tokenu dewelopera. Przewodnik Poziomy dostępu i dozwolone użycie zawiera informacje o konkretnych limitach operacji interfejsu API dla poszczególnych poziomów dostępu.
Żądania, które przekraczają te limity, są odrzucane z błędem RESOURCE_EXHAUSTED.
Ograniczenia gRPC
Wszystkie biblioteki klienta interfejsu Google Ads API używają protokołu gRPC do generowania żądań i odpowiedzi. Domyślny rozmiar wiadomości gRPC to 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 zawierają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 lub użyć strumieniowania. W przypadku operacji zmiany wysyłaj mniej operacji na żądanie.
Prośby, które naruszają to ograniczenie, nie wygenerują błędu GoogleAdsError, ale błąd429 Resource Exhausted gRPC. Zapoznaj się z listą kodów błędów i komunikatów gRPC.
Zmiana żądań
Oprócz tego, że żądanie jest wliczane do dziennego limitu operacji użytkownika,nie może ono zawierać więcej niż 10 tys. operacji na żądanie.
Prośby, które naruszają to ograniczenie, są odrzucane z błędem:
TOO_MANY_MUTATE_OPERATIONS.
Poniżej znajdziesz dodatkowe limity i uwagi dotyczące konkretnych 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 jest liczone jako 1 operacja interfejsu API niezależnie od liczby partii.
Żądania po stronie
Żądania po stronie (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ą wliczane do dziennego limitu operacji.
Więcej informacji o podziałach na strony znajdziesz w artykule Przeglądanie wyników na stronach.
Inne typy żądań
Prośba, która nie jest prośbą Get, Mutate, Search ani SearchStream, jest liczona jako 1 operacja w ramach dziennej puli operacji użytkownika.
Oto kilka przykładów takich próśb:
BatchJobService.ListMutateJobResultsConversionUploadService.UploadCallConversionsConversionUploadService.UploadClickConversionsOfflineUserDataJobService.AddOfflineUserDataJobOperationsOfflineUserDataJobService.CreateOfflineUserDataJobUserDataService.UploadUserData
Żądania z wyjątkami interfejsu API
Żądania odrzucone z powodu błędu GoogleAdsFailure są nadal uwzględniane w liczbie operacji dozwolonych na użytkownika w ciągu dnia.
Żądania, które nie powiodły się, ale nie zwracająGoogleAdsFailure, np. z powodu błędu na poziomie sieci, nie będą wliczane do dziennej kwoty operacji użytkownika, ponieważ żądania nigdy nie dotrą do usługi. Przykładem może być utrata połączenia z siecią.
Usługi planowania
Ze względu na koszty i złożoność te metody usługi planowania podlegają oddzielnym limitom niż inne typy żą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 QPS to 60 żądań na 60 sekund.
Ograniczenie do 2 zapytań na sekundę na ID klienta:
Pamiętaj o tych limitach podczas tworzenia planu słów kluczowych.
| Obiekt planu dotyczący 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 wywołania lub kliknięcia na prośbę:
Żądania, które przekraczają te limity, są odrzucane z błędem
TOO_MANY_CONVERSIONS_IN_REQUEST.
Usługa przesyłania korekty konwersji
Ograniczenie do 2000 korekt konwersji na żądanie:
Żądania, które przekraczają 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ń typu mutate dozwolona jest tylko 1 operacja.
Prośby, które naruszają to ograniczenie, są odrzucane z błędem:
TOO_MANY_MUTATE_OPERATIONS.Między zmianami kolejności budżetów na tym samym koncie musi upłynąć co najmniej 12 godzin. Wprowadzanie zmian w ciągu 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ą adresu CustomerUserAccessService. Ponieważ ta funkcja wysyła e-maile z zaproszeniem do innych użytkowników, może być nadużywana, dlatego jej działanie jest ograniczone:
Użytkownicy nie mogą otrzymywać więcej niż 1 oczekującego zaproszenia do tego samego konta klienta. Jeśli kolejna prośba o wysłanie zaproszenia do użytkownika, który ma już oczekujące zaproszenie, wróci ten błąd:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.Na kontach klientów nie może być więcej niż 70 oczekujących zaproszeń naraz. Jeśli zostanie wysłane żądanie, które powoduje przekroczenie tej wartości, zwracany jest ten błąd:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.
Dane użytkownika
Dane użytkowników są zarządzane za pomocą interfejsów UserDataService i OfflineUserDataJobService.
W przypadku operacji tworzenia lub usuwania UserData każdy zestaw user_identifiers powinien być przypisany do konkretnego 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, 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ą powtarzalnego pola, spróbuj zmniejszyć liczbę elementów w powtarzalnym polu, wdrażając listę operacji w żądaniu zmiany.
W zapytaniu GAQL maksymalna liczba elementów w nawiasach klamrowych IN wynosi 20 tys. Jeśli przekroczysz ten limit, zwrócony zostanie błąd FILTER_HAS_TOO_MANY_VALUES.