Limity

Interfejs Google Ads API egzekwuje ograniczenia operacji interfejsu API, takich jak liczba operacji, które można wysłać w jednym żądaniu zmiany. W tabeli poniżej znajdziesz podsumowanie niektórych ważnych limitów, o których musisz 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 API dziennie RESOURCE_EXHAUSTED
Zmień żądania 10 000 operacji na żądanie TOO_MANY_MUTATE_OPERATIONS
Prośby o usługę Planning 1 zapytanie na sekundę RESOURCE_EXHAUSTED
Żądania usługi przesyłania konwersji 2000 konwersji na żądanie TOO_MANY_CONVERSIONS_IN_REQUEST
Prośby o usługę dotyczącą płatności i budżetu konta 1 operacja na żądanie zmiany TOO_MANY_MUTATE_OPERATIONS

Dzienne limity operacji interfejsu API

Dzienne limity wykorzystania interfejsu API są obliczane na podstawie liczby operacji interfejsu API wykonanych na token programisty. Operacje API to łączna suma żądań get i operacji mutacji. Limity dziennych operacji przy użyciu interfejsu API zależą od poziomu dostępu do tokena programisty. W przewodniku po poziomach dostępu i dozwolonym użyciu opisano limity dotyczące operacji interfejsu API obowiązujące w przypadku poszczególnych poziomów dostępu.

Żądania, które naruszają te limity, są odrzucane z komunikatem o błędzie: RESOURCE_EXHAUSTED.

Ograniczenia gRPC

Wszystkie biblioteki klienta interfejsu Google Ads API używają do generowania żądań i odpowiedzi gRPC. Domyślnie gRPC ma rozmiar wiadomości 4 MB, ale nasze biblioteki klienta ustawiły maksymalny rozmiar wiadomości na 64 MB, aby zwiększyć wydajność.

Liczba odpowiedzi nie może przekraczać tego limitu. Na przykład: wyszukiwanie obejmują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, 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 wygenerują zdarzenia GoogleAdsError, ale wywołają błąd gRPC 429 Resource Exhausted. Zapoznaj się z listą kodów błędów i komunikatów o błędach gRPC.

Zmień żądania

Oprócz wliczanego 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 tym błędem: TOO_MANY_MUTATE_OPERATIONS.

Poniżej przedstawiamy dodatkowe ograniczenia i uwagi dotyczące określonych 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 liczy się jako 1 operacja interfejsu API niezależnie od liczby wsadów.

Żądania z podziałem na strony

Żądania podzielone na strony (np. żądania zawierające prawidłowy element 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, będą generować wyjątek i będą wliczane do dziennego limitu operacji.

Żądania podzielone na strony, takie jak żądania wyszukiwania, również podlegają ograniczeniu Page size cannot exceed 10,000 rows i są odrzucane, jeśli naruszają ten limit, z komunikatem o błędzie: INVALID_PAGE_SIZE.

Więcej informacji o podziale wyników na strony znajdziesz w artykule Podział wyników na strony.

Inne typy próśb

Żądanie, które nie jest żądaniem Get, Mutate, Search ani SearchStream, jest liczone jako jedna operacja w ramach dziennego limitu operacji użytkownika.

Oto kilka przykładów takich próśb:

Żądania, które zwracają wyjątki od interfejsu API

Żądania odrzucone za pomocą GoogleAdsFailure nadal są wliczane do dziennego limitu operacji użytkownika.

Żądania, które kończą się niepowodzeniem, ale nie zwracają GoogleAdsFailure, np. z powodu błędu na poziomie sieci, nie są wliczane do dziennego limitu operacji użytkownika, ponieważ nie dotarłyby do usługi. Przykładem może być błąd połączenia sieciowego.

Usługi planowania

Ze względu na koszty i złożoność opisane poniżej metody usługi Planning podlegają innym ograniczeniom niż inne typy żądań.

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

Usługa przesyłania korekty konwersji

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 tym błędem: MUTATE_NOT_ALLOWED.

  • W przypadku żądań zmiany dozwolona jest tylko 1 operacja.

    Żądania, które naruszają to ograniczenie, są odrzucane z tym błędem: TOO_MANY_MUTATE_OPERATIONS.

  • Między wprowadzeniem zmian w zamówieniu budżetowym na tym samym koncie należy odczekać co najmniej 12 godzin. Wprowadzenie zmian przed upływem 12 godzin może spowodować nieodwracalne błędy, które mogą rozwiązać tylko przedstawiciel ds. konta Google Ads.

Zaproszenia do kont klientów

Nowych użytkowników można zapraszać do istniejących kont klientów za pomocą CustomerUserAccessService. Ta funkcja wysyła e-maile z zaproszeniami do innych użytkowników, więc może zostać niewłaściwie wykorzystywana. Obowiązują ograniczenia w tym działaniu:

Dane użytkownika

Dane użytkownika są zarządzane za pomocą UserDataService i OfflineUserDataJobService. W ramach danej operacji tworzenia/usuwania UserData każdy zestaw elementów user_identifiers powinien dotyczyć tylko 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 jest więcej niż 20 user_identifiers.

Inne typy limitów

Pole powtarzane, na przykład 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 wynikać z innych problemów.

Jeśli napotkasz to ograniczenie i wysyłasz żądania, które korzystają z pola powtarzanego, spróbuj zmniejszyć liczbę elementów w polu powtarzanym, wdrażając listę operacji w żądaniu mutacji.

Podczas tworzenia zapytania GAQL maksymalna liczba elementów w klauzuli IN wynosi 20 000. Jeśli przekroczysz ten limit, zostanie zwrócony błąd FILTER_HAS_TOO_MANY_VALUES.