Limity

Interfejs Google Ads API wymusza limity operacji w interfejsie API, np. liczbę operacji które można wysłać w pojedynczym żądaniu mutacji. W tabeli poniżej znajdziesz podsumowanie niektórych z tych o ważnych ograniczeniach, 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 opierają się na liczbie interfejsów API operacji wykonywanych za pomocą tokena programisty. API to łączna suma żądań get i operacji mutacji. Ograniczenia w przypadku codziennych operacji interfejsu API zależy od poziomu dostępu do tokena programisty. W przewodniku dotyczącym poziomów dostępu i dozwolonego użycia określone limity operacji API dla poszczególnych poziomów dostępu.

Żądania, które naruszają te limity, są odrzucane z powodu błędu: RESOURCE_EXHAUSTED.

Ograniczenia gRPC

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

Liczba odpowiedzi nie może przekraczać tego limitu. Na przykład żądanie wyszukiwania, które Zawiera wiele pól, może generować odpowiedź o rozmiarze przekraczającym 64 MB. Do uniknąć tego limitu, zmniejszyć liczbę wybranych pól, zmniejszyć liczbę lub skorzystaj ze strumieniowego przesyłania danych. W przypadku mutacji wyślij mniej operacji na żądanie.

Żądania, które naruszają to ograniczenie, nie generują odpowiedzi GoogleAdsError, ale wygeneruje Błąd gRPC: 429 Resource Exhausted. Zapoznaj się z listą kodów błędów gRPC oraz wiadomości.

Żądania mutacji

Oprócz wliczania do dziennego limitu operacji użytkownika może zawierać maksymalnie 10 000 operacji na jedno żądanie.

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

Dodatkowe ograniczenia i kwestie związane z konkretnymi usługami i typami żądań: opisane poniżej.

Żądania wyszukiwania

Żądanie Search lub SearchStream jest liczone jako jedna operacja względem żądania użytkownika dziennego limitu operacji. Jedno żądanie SearchStream liczy się jako 1 operacja interfejsu API niezależnie od liczby partii.

Żądania z podziałem na strony

Żądania podzielone na strony (na przykład żądania zawierające prawidłową wartość next_page_token) nie są wliczane do dziennego limitu operacji użytkownika. Żądania podziału na strony, które zawierają wygasły lub nieprawidłowy token strony, wygeneruje wyjątek i będzie wliczany do dziennego limitu operacji.

Żądania podzielone na strony, takie jak żądania wyszukiwania, również podlegają Page size cannot exceed 10,000 rows. Są one odrzucane, jeśli naruszają z tym błędem: INVALID_PAGE_SIZE.

Więcej informacji o dzieleniu na strony znajdziesz w artykule Tempo wyników.

Inne typy żądań

Żądanie, które nie jest żądaniami typu Get, Mutate, Search ani SearchStream liczy się jako jedną operację w dziennym limicie operacji użytkownika.

Oto kilka przykładów takich żądań:

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

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

Żądania, które kończą się niepowodzeniem, ale nie zwracają błędu GoogleAdsFailure, np. z powodu błędu w na poziomie sieci, nie wlicza się do dziennego limitu operacji ponieważ żądania nigdy nie dotrą do usługi. Na przykład: Błąd połączenia sieciowego.

Usługi planowania

Ze względu na koszty i złożoność metod usługi Planning wymienione poniżej są podlegają odrębnym limitom dotyczącym innych typów żą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 powodu błędu: MUTATE_NOT_ALLOWED.

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

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

  • Między zmianami zamówień budżetowych a konfiguracją budżetu należy odczekać co najmniej 12 godzin to samo konto. Wprowadzanie zmian przed upływem 12 godzin może spowodować nieodwracalne błędy, które mogą rozwiązać tylko Twoje konto Google Ads; przedstawiciel handlowy.

Zaproszenia do kont klientów

Nowych użytkowników można zapraszać do istniejących kont klientów za pomocą CustomerUserAccessService. Ponieważ wysyła e-maile z zaproszeniami do innych użytkowników, może niewłaściwe użycie, dlatego jego działanie podlega ograniczeniom:

Dane użytkownika

Do zarządzania danymi użytkownika służy aplikacja UserDataService oraz OfflineUserDataJobService. W danej operacji tworzenia/usuwania UserData każda zbiór user_identifiers powinny być powiązane z konkretnym użytkownikiem.

Aby to wyegzekwować: OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS lub UserDataError.TOO_MANY_USER_IDENTIFIERS jest zwracany, jeśli wuser_identifiers Ustawiono UserData.

Inne typy limitów

Pole powtarzane, takie jak lista operacji, które zawiera za dużo elementów w może spowodować błąd: REQUEST_SIZE_LIMIT_EXCEEDED. Ten sam komunikat o błędzie może być spowodowany innymi problemami.

Jeśli natrafisz na to ograniczenie i przesyłasz żądania, które powielają , spróbuj zmniejszyć liczbę elementów w polu powtarzanym, stosując lista operacji w żądaniu mutacji.

W zapytaniu GAQL maksymalna liczba elementów w klauzuli IN wynosi 20 000. Jeśli przekroczysz ten limit, FILTER_HAS_TOO_MANY_VALUES .

Wstecz
Przegląd
Dalej
Ograniczenia systemu