Interfejs Google Ads API wymusza limity operacji interfejsu API, na przykład liczbę operacji, które można wysłać w pojedynczym żądaniu mutacji. W tabeli poniżej znajdziesz podsumowanie niektórych ważnych limitów i limitów, o których warto pamiętać.
| Typ żądania, ograniczenie i kod błędu | ||
|---|---|---|
| Operacje z podstawowym dostępem | 15 tys. operacji API dziennie |
RESOURCE_EXHAUSTED
|
| Zmiana żądań | 10 000 operacji na żądanie |
TOO_MANY_MUTATE_OPERATIONS
|
| Planowanie żądań usługi | 1 zapytanie/s |
RESOURCE_EXHAUSTED
|
| Prośby o usługę przesyłania konwersji | 2000 konwersji na żądanie |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
| Żądania dotyczące płatności i budżetu konta | 1 operacja na żądanie zmiany |
TOO_MANY_MUTATE_OPERATIONS
|
Dzienne limity operacji interfejsu API
Dzienne limity korzystania z 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 programisty. W przewodniku Poziomy dostępu i dozwolone użycie znajdziesz 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ą gRPC do generowania żądań i odpowiedzi. Domyślnie rozmiar wiadomości gRPC wynosi 4 MB, ale nasze biblioteki klienta ustawiają maksymalny rozmiar wiadomości na 64 MB, co zwiększa 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 wygenerują błąd gRPC 429 Resource Exhausted. 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.
Żądania, 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 pogrupowane (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ą uwzględniane w liczbie operacji dozwolonych w ramach dziennego limitu.
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, które zostały odrzucone z powodu błędu GoogleAdsFailure, nadal są 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 puli 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
Ograniczone do 2000 dostosowań konwersji na żądanie:
Żądania, które przekraczają te limity, są odrzucane z błędem
TOO_MANY_ADJUSTMENTS_IN_REQUEST.
Usługi dotyczące płatności i budżetu 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ń mutacji dozwolona jest tylko operacja 1.
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. Wprowadzenie zmian przed upływem 12 godzin może spowodować nieodwracalne błędy, które może rozwiązać tylko przedstawiciel konta Google Ads.
Zaproszenia na konta klientów
Nowych użytkowników można zapraszać do korzystania z istniejących kont klientów za pomocą narzędzia CustomerUserAccessService. Ta funkcja wysyła e-maile z zaproszeniami do innych użytkowników, więc może być niewłaściwie wykorzystywana. Z tego powodu jej działanie jest ograniczone:
Na tym samym koncie klienta użytkownik może otrzymać tylko jedno oczekujące zaproszenie. 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 wysłane żądanie 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 danej operacji tworzenia lub usuwania UserData każdy zestaw user_identifiers powinien być powiązany z konkretnym użytkownikiem.
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 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ć 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, stosując listę operacji w żądaniu modyfikacji.
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.