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 poniższej tabeli znajdziesz podsumowanie o ważnych ograniczeniach, o których należy pamiętać.

Typ żądania, ograniczenie i kod błędu
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. Interfejs 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 należy unikać tego limitu, można zmniejszyć liczbę wybranych pól lub użyć strumieniowaniem. W przypadku mutacji wysyłaj 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ń: przedstawiony 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.

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ść tych metod usługi w narzędziu Planning 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 ramach danej operacji tworzenia lub 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, gdy w argumencie user_identifiers istnieje więcej niż 20 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