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 poniższej tabeli znajdziesz podsumowanie wybranych ważnych limitów i limitów, o których należy 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 interfejsu API dziennie |
RESOURCE_EXHAUSTED
|
|
Żądania mutacji | 10 000 operacji na żądanie |
TOO_MANY_MUTATE_OPERATIONS
|
|
Zapytania o usługę planowania | 1 QPS |
RESOURCE_EXHAUSTED
|
|
Żądania usługi 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 mutacji |
TOO_MANY_MUTATE_OPERATIONS
|
Dzienne limity operacji interfejsu API
Dzienne limity wykorzystania interfejsu API są określane na podstawie liczby operacji interfejsu API wykonywanych przez każdy token programisty. Operacje interfejsu API to łączna suma żądań get i operacji mutacji. Limity dziennych operacji interfejsu API zależą od poziomu dostępu do tokena programisty. W przewodniku na temat poziomów dostępu i dozwolonych zastosowań opisane są limity działania interfejsu API obowiązujące w przypadku poszczególnych poziomów 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 rozmiar wiadomości gRPC wynosi 4 MB, ale nasze biblioteki klienta ustawiają maksymalny rozmiar wiadomości na 64 MB, co zwiększa wydajność.
Liczba odpowiedzi nie może przekraczać tego limitu. Na przykład żądanie wyszukiwania, które obejmuje wiele pól, może spowodować wygenerowanie odpowiedzi 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 generują GoogleAdsError
, ale błąd gRPC 429 Resource Exhausted
. Zapoznaj się z listą kodów błędów i komunikatów gRPC.
Żądania mutacji
Oprócz wliczania 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 błędem: TOO_MANY_MUTATE_OPERATIONS
.
Poniżej znajdziesz dodatkowe ograniczenia i uwagi dotyczące konkretnych usług oraz typów żądań.
Żądania wyszukiwania
Żądanie Search
lub SearchStream
jest liczone jako 1 operacja w dziennym limicie operacji użytkownika. Jedno żądanie SearchStream
jest liczone jako 1 operacja interfejsu API niezależnie od liczby wsadów.
Żądania z podziałem na strony
Żądania podzielone na strony (na przykład żądania zawierające prawidłowy atrybut 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, spowodują wygenerowanie wyjątku i będą wliczane do dziennego limitu operacji.
Żądania podzielone na strony, np. żądania wyszukiwania, również podlegają ograniczeniom Page size cannot exceed 10,000 rows
. Są one odrzucane, jeśli naruszają ten limit, z tym błędem: INVALID_PAGE_SIZE
.
Więcej informacji o podziale na strony znajdziesz w tym artykule.
Inne typy żądań
Żądania, które nie są żądaniami Get
, Mutate
, Search
ani SearchStream
, są wliczane do jednej operacji w dziennym limicie operacji użytkownika.
Oto kilka przykładów takich żądań:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
Żądania, które zwracają wyjątki dotyczące interfejsu API
Żądania odrzucone przy użyciu GoogleAdsFailure
nadal są wliczane do dziennego limitu operacji użytkownika.
Żądania, które kończą się niepowodzeniem, ale nie zwracają GoogleAdsFailure
, na przykład w wyniku błędu na poziomie sieci, nie są wliczane do dziennego limitu operacji użytkownika, ponieważ takie żądania nigdy nie dotrą do usługi. Przykładem może być awaria
połączenia sieciowego.
Usługi planowania
Ze względu na koszty i złożoność poniższe metody usługi Planning podlegają ograniczeniom niż w przypadku innych typów żądań.
Ograniczone do 1 żądania na sekundę na każdy identyfikator klienta lub token programisty:
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
Żądania, które naruszają te ograniczenia, są odrzucane z błędem:
RESOURCE_EXHAUSTED
.Wartość 1 zapytań na sekundę jest obliczana jako 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
Obowiązuje ograniczenie do 2000 konwersji telefonicznych lub kliknięć na żądanie:
Żądania, które naruszają 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 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 do fakturowania miesięcznego.
Żądania, które naruszają to ograniczenie, są odrzucane z błędem:
MUTATE_NOT_ALLOWED
.W przypadku żądań mutacji dozwolona jest tylko operacja 1.
Żądania, które naruszają to ograniczenie, są odrzucane z błędem:
TOO_MANY_MUTATE_OPERATIONS
.Między zmianami zamówień budżetowych na tym samym koncie musisz odczekać 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 do kont klientów
Nowych użytkowników można zapraszać do korzystania z istniejących kont klientów za pomocą narzędzia CustomerUserAccessService
. Ponieważ ta funkcja wysyła e-maile z zaproszeniami do innych użytkowników, może ona zostać niewłaściwie wykorzystana, a jej działanie podlega pewnym ograniczeniom:
Na tym samym koncie klienta użytkownik może otrzymać tylko jedno oczekujące zaproszenie. Jeśli pojawi się kolejne żądanie wysłania 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
.Na kontach klientów nie może być naraz więcej niż 70 oczekujących zaproszeń. 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
Do zarządzania danymi użytkownika służą UserDataService
i OfflineUserDataJobService
.
W danej operacji tworzenia/usuwania UserData
każdy zbiór elementów user_identifiers
powinien być przypisany do konkretnego użytkownika.
Aby to egzekwować, jeśli zbiór user_identifiers
zawiera więcej niż 20 zbiorów user_identifiers
, zwracany jest błąd OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
lub UserDataError.TOO_MANY_USER_IDENTIFIERS
.UserData
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ć spowodowany innymi problemami.
Jeśli napotkasz to ograniczenie i wysyłasz żądania z wykorzystaniem pola powtarzanego, spróbuj zmniejszyć liczbę elementów w polu powtarzanym, wdrażając listę operacji w żądaniu mutacji.
W przypadku zapytania GAQL maksymalna liczba elementów w klauzuli IN
wynosi 20 000. Jeśli przekroczysz ten limit, zwracany jest błąd FILTER_HAS_TOO_MANY_VALUES
.