Limity interfejsu API

Interfejs Google Ads API wymusza limity operacji interfejsu API, takich jak liczba operacji, które można wysłać w jednym żądaniu mutacji. W poniższej tabeli podsumowujemy niektóre z ważnych limitów.

Typ żądania, ograniczenie i kod błędu
Żądania z podziałem na strony 10 000 wierszy na stronie INVALID_PAGE_SIZE
Operacje z dostępem podstawowym 15 000 operacji API dziennie RESOURCE_EXHAUSTED
Żądania 1000 żądań dziennie RESOURCE_EXHAUSTED
Prośby o mutację 10 000 operacji na żądanie TOO_MANY_MUTATE_OPERATIONS
Żądania usługi Planning 1 QPS RESOURCE_EXHAUSTED
Żądania usługi przesyłania konwersji 2000 konwersji na żądanie TOO_MANY_CONVERSIONS_IN_REQUEST
Prośby dotyczące usług rozliczeniowych i budżetu konta 1 operacja na żądanie mutacji TOO_MANY_MUTATE_OPERATIONS

Dzienny limit operacji w interfejsie API

Dzienne limity korzystania z interfejsu API są oparte na liczbie działań interfejsu API wykonywanych na tokenie programisty. Operacje interfejsu API to łączna liczba żądań pobrania i operacji mutacji. Limity dziennych operacji interfejsu API zależą od poziomu dostępu tokena dewelopera. W przewodniku po poziomach dostępu i dozwolonych zastosowaniach opisujemy limity operacji interfejsu API dla 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 API Google Ads używają gRPC do generowania żądań i odpowiedzi. Domyślnie gRPC ma rozmiar wiadomości 4 MB, ale nasze biblioteki klienckie ustawiają maksymalny rozmiar wiadomości na 64 MB, aby zwiększyć wydajność.

Liczba odpowiedzi nie może przekraczać tego limitu. Na przykład zapytanie 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, zmniejszyć rozmiar strony lub użyć strumieniowania. W przypadku mutacji wysyłaj mniej operacji na żądanie.

Żądania, które naruszają to ograniczenie, nie będą generować GoogleAdsError, ale będą generować błąd 429 Resource Exhausted gRPC. Zapoznaj się z listą kodów błędów gRPC i komunikatów.

Żądania są wycofane (wycofane)

Żądania (np. z użyciem metody GetCampaign w CampaignService) mają dzienne ograniczenia użycia, które nie są objęte limitami dotyczącymi działań wymienionych w przewodniku po poziomach dostępu i dozwolonych zastosowaniach.

W odróżnieniu od codziennych operacji limity żądań otrzymywania nie różnią się w zależności od poziomu dostępu. Wszystkie tokeny programisty, w tym te z dostępem standardowym, są ograniczone do 1000 żądań dziennie.

W przeciwieństwie do żądań wyszukiwania pobieranie żądań jest kosztowne, ponieważ wszystkie dane atrybutów są pobierane. Dlatego zalecamy, by w miarę możliwości korzystać z wyszukiwarki, zamiast korzystać z opcji get.

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

Prośby o mutację

Oprócz ograniczenia dziennego limitu użytkownika 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 limity i wskazówki dotyczące konkretnych usług i typów żądań.

Żądania wyszukiwania

Żądanie Search lub SearchStream liczy się jako jedna operacja i jednocześnie przekracza dzienny limit operacji. Jedno żądanie SearchStream jest liczone jako 1 operacja interfejsu API niezależnie od liczby wsadów.

Żądania z podziałem na strony

Żądania z podziałem na strony (na przykład żądania zawierające prawidłowy next_page_token) nie są wliczane do dziennego limitu operacji użytkownika. Jednak żądania dotyczące podziału na strony, które zawierają wygasły lub nieprawidłowy token strony, będą generować wyjątek i będą wliczać się do dziennego limitu operacji.

Podział treści na strony, np. żądania wyszukiwania, podlega ograniczeniom Page size cannot exceed 10,000 rows i jest odrzucany, jeśli narusza ten limit, ale zawiera błąd: INVALID_PAGE_SIZE.

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

Inne rodzaje próśb

Żądanie, które nie jest żądaniem Get, Mutate, Search ani SearchStream, jest liczone jako jedna operacja i przekracza limit dzienny.

Przykłady takich żądań:

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

Żądania, które zostały odrzucone przy użyciu GoogleAdsFailure, nadal wliczają się do dziennego limitu operacji użytkownika.

Żądania, które zakończyły się niepowodzeniem, ale nie zwracają GoogleAdsFailure, na przykład z powodu błędu na poziomie sieci, nie będą wliczane do dziennego limitu aktywności użytkownika, ponieważ te żądania nigdy nie uzyskają dostępu 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ść poniższych metod usługi Planning podlegają innym ograniczeniom niż pozostałe 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 za KeywordPlan 200
KeywordPlanAdGroupKeyword za KeywordPlan 10 000
KeywordPlanCampaignKeyword (wykluczające słowa kluczowe) 1000
KeywordPlanCampaign za KeywordPlan 1

Usługa przesyłania konwersji

Usługa przesyłania dostosowań konwersji

Usługi w zakresie rozliczeń i budżetu konta

  • Mutacje można stosować tylko w przypadku kont skonfigurowanych do fakturowania miesięcznego.

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

  • W przypadku żądań mutacji dozwolone jest tylko 1 działanie.

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

  • Po zmianie zamówienia budżetowego musisz odczekać co najmniej 12 godzin na tym samym koncie. Wprowadzenie zmian przed upływem 12 godzin może spowodować nieodwracalne błędy, które można rozwiązać tylko z poziomu przedstawiciela konta Google Ads.

Zaproszenia na konta klientów

Nowych użytkowników można zapraszać na istniejące konta klientów za pomocą interfejsu CustomerUserAccessService. Ze względu na to, że ta funkcja wysyła e-maile z zaproszeniami do innych użytkowników, może ona zostać użyta w niewłaściwy sposób, co ogranicza możliwości:

Dane użytkownika

Dane użytkownika są zarządzane przez UserDataService oraz OfflineUserDataJobService. W ramach operacji tworzenia/usuwania UserData każdy zestaw user_identifiers powinien być przypisany do jednego użytkownika.

Aby to wymusić, zwracany jest błąd OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS lub UserDataError.TOO_MANY_USER_IDENTIFIERS, gdy w zestawie UserData znajduje się więcej niż 20 user_identifiers.

Inne typy limitów

Powtarzające się pole, na przykład z listą operacji, które zawierają zbyt wiele elementów w żądaniu, może spowodować błąd: REQUEST_SIZE_LIMIT_EXCEEDED. Ten sam komunikat o błędzie może też wynikać z innych problemów.

Jeśli napotkasz to ograniczenie i będziesz wysyłać żądania z powtarzającym się polem, spróbuj zmniejszyć liczbę elementów w powtarzanym polu, wdrażając listę operacji w żądaniu mutacji.

W zapytaniu GAQL maksymalna liczba elementów w klauzuli IN to 20 000. Po przekroczeniu limitu zwracany jest błąd FILTER_HAS_TOO_MANY_VALUES.