Interfejs Google Ads API nakłada limity na operacje API, np. na 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 limitów, o których warto pamiętać.
| Typ żądania, ograniczenie i kod błędu | ||
|---|---|---|
| Operacje z podstawowym dostępem | 15 tys. operacji interfejsu API dziennie |
RESOURCE_EXHAUSTED
|
| Zmiana żądań | 10 000 operacji na żądanie |
TOO_MANY_MUTATE_OPERATIONS
|
| Zapytania dotyczące planowania | 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
Dzienne limity korzystania z interfejsu API są określane na podstawie liczby operacji 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 klienckie 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ń.
Wyszukaj żądania
Żą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 posortowane (np. żądania zawierające prawidłowy parametr 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
GoogleAdsFailure, nadal wliczają się do dziennego limitu operacji użytkownika.
Żą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ługa planowania słów kluczowych
Ze względu na koszty i złożoność te metody usługi Planowanie słów kluczowych podlegają oddzielnym limitom 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 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 Statystyki 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 wywołania lub kliknięcia na prośbę:
Żądania, które naruszają 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 rozliczeniowe i budżetowe
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 kolejności budżetów na tym samym koncie należy odczekać 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;
Nowi użytkownicy mogą być zapraszani na istniejące konta klientów za pomocą CustomerUserAccessService. Ta funkcja wysyła e-maile z zaproszeniem do innych użytkowników, więc może być nadużywana. Z tego powodu 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 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 operacji tworzenia lub usuwania UserData każdy zestaw user_identifiers powinien być przypisany do konkretnego użytkownika.
W tym celu, gdy w zbiorze UserData jest więcej niż 20 elementów user_identifiers, zwracany jest błąd OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS lub UserDataError.TOO_MANY_USER_IDENTIFIERS.
Możesz podać maksymalnie 100 000 identyfikatorów użytkowników niezależnie od liczby operacji.
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 klauzuli IN wynosi 20 tys. Jeśli przekroczysz ten limit, zwrócony zostanie błądFILTER_HAS_TOO_MANY_VALUES.