Typowe błędy

Na tej stronie znajdziesz listę typowych błędów oraz wskazówki, jak im zapobiegać i jak sobie z nimi radzić. Pełną listę błędów znajdziesz w dokumentacji błędów, przewodniku po błędach interfejsu API lub przewodniku po typach błędów. Aby uzyskać dalszą pomoc, skontaktuj się z zespołem pomocy interfejsu Google Ads API.

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Podsumowanie Token dostępu OAuth 2.0 nie ma wymaganych zakresów. Typowe przyczyny Żądanie zostało odrzucone, ponieważ podany token dostępu nie zawiera zakresu OAuth 2.0 interfejsu Google Ads API. Jak postępować Sprawdź, czy token dostępu ma wymagane zakresy. Częstą przyczyną tego błędu jest ponowne użycie istniejącego tokena dostępu, który został wygenerowany przy użyciu innego zestawu zakresów OAuth. Przykład generowania nowego tokena dostępu z wymaganymi zakresami znajdziesz w sekcji Parametry autoryzacji OAuth. Wskazówki dotyczące profilaktyki Sprawdź, czy token dostępu ma wymagane zakresy. Ponownie uwierzytelnij użytkownika z wymaganymi zakresami, aby uzyskać dostęp z wymaganymi zakresami. Jeśli Twoja aplikacja używa wielu zakresów OAuth, może być konieczne wdrożenie szczegółowych uprawnień OAuth.

google.auth.exceptions.RefreshError

invalid_grant

Podsumowanie Token wygasł lub został unieważniony. Typowe przyczyny W przypadku projektu Google Cloud Platform ze skonfigurowanym ekranem zgody OAuth dla zewnętrznego typu użytkownika i stanem publikacji Testing wydawany jest token odświeżania, który wygasa po 7 dniach. Jak postępować Stan publikowania projektu Google to Testing, więc token odświeżania wygasa co 7 dni i wyświetla błąd invalid_grant. Otwórz Konsolę interfejsów API Google i przejdź do ekranu zgody OAuth. Następnie zmień stan publikacji na In production, aby uniknąć wygaśnięcia tokena odświeżania za 7 dni. Wskazówki dotyczące profilaktyki Zobacz Niezweryfikowane aplikacje.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Podsumowanie Tego operatora nie można używać z podklasą Ad. Typowe przyczyny Próbujesz zmodyfikować atrybuty inne niż status reklamy. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Po utworzeniu reklamy nie można jej zmienić. Jeśli chcesz zmodyfikować reklamę, musisz utworzyć nową, a potem usunąć starą. status reklamy można jednak modyfikować za pomocą funkcji MutateAdGroupAds.
INVALID_INPUT	Podsumowanie Jedno z pól w reklamie zawiera nieprawidłowe znaki. Typowe przyczyny Używanie znaków specjalnych w adresach URL. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Zanim wyślesz żądanie do interfejsu API, sprawdź adresy URL w aplikacji.
LINE_TOO_WIDE	Podsumowanie Jedno z pól w reklamie było dłuższe niż maksymalna dozwolona długość. Zobacz Reklamy tekstowe. Typowe przyczyny zbyt długi wiersz tekstu; Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Przed wysłaniem żądania do interfejsu API sprawdź długość wiersza.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Podsumowanie Ta etykieta jest już powiązana z częścią reklam. Typowe przyczyny Próbujesz powiązać etykietę z reklamami, które są już z nią powiązane. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Najpierw sprawdź, czy etykieta, którą chcesz dodać, jest już powiązana z reklamami.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Podsumowanie Podjęto próbę zaktualizowania usuniętej reklamy. Typowe przyczyny Po usunięciu reklamy nie można jej już aktualizować, w tym zmieniać jej stanu. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy kod nie próbuje aktualizować usuniętych reklam.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Podsumowanie Tekst słowa kluczowego zawiera nieprawidłowe znaki. Zobacz Dodawanie słów kluczowych. Typowe przyczyny Tekst słowa kluczowego zawiera nieprawidłowe znaki. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Zanim wyślesz żądanie do interfejsu API, sprawdź tekst słowa kluczowego w aplikacji.

AdGroupError

DUPLICATE_ADGROUP_NAME

Podsumowanie Dodajesz lub zmieniasz nazwę grupy reklam, ale ta nazwa jest już używana przez inną grupę reklam. Typowe przyczyny Tworzenie nowej grupy reklam o nazwie istniejącej aktywnej lub wstrzymanej grupy reklam. Jak postępować Zapisz błąd i wyświetl użytkownikowi komunikat o błędzie, opcjonalnie sugerując unikalną nazwę grupy reklam lub wyświetlając listę używanych nazw. Wskazówki dotyczące profilaktyki Nie dotyczy

AssetError

DUPLICATE_ASSET

Podsumowanie 2 operacje w jednym żądaniu zawierają operację tworzenia komponentu z tymi samymi danymi binarnymi. Typowe przyczyny Żądanie zmiany z zduplikowanymi operacjami tworzenia zawierającymi te same dane binarne. Jak postępować Utwórz zasób w osobnym żądaniu, a potem połącz go z kolejnym żądaniem lub użyj tymczasowego identyfikatora w tym samym żądaniu. Wskazówki dotyczące profilaktyki Nie dotyczy

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Podsumowanie Identyfikator klienta nie jest liczbą. Typowe przyczyny Używanie nieprawidłowego identyfikatora klienta. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Numer 123-456-7890 powinien mieć format 1234567890. Więcej informacji znajdziesz w artykule Pierwsze kroki.
CLIENT_CUSTOMER_ID_IS_REQUIRED	Podsumowanie W nagłówku HTTP nie podano identyfikatora klienta. Typowe przyczyny Nie podajesz identyfikatora klienta w nagłówku HTTP. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Identyfikator klienta jest wymagany w przypadku wszystkich wywołań, więc upewnij się, że został on podany w nagłówku HTTP. Rozważ użycie naszych bibliotek klienta, ponieważ one zajmują się tym za Ciebie.
CUSTOMER_NOT_FOUND	Podsumowanie Nie znaleziono konta dla identyfikatora klienta podanego w nagłówku. Typowe przyczyny Próba uzyskania dostępu do konta, które zostało właśnie utworzone, zanim zostanie ono skonfigurowane na serwerze backendu. Jak postępować Odczekaj 5 minut, a potem spróbuj ponownie co 30 sekund. Wskazówki dotyczące profilaktyki Po utworzeniu konta odczekaj kilka minut, zanim zaczniesz wysyłać do niego żądania.
GOOGLE_ACCOUNT_COOKIE_INVALID	Podsumowanie Token dostępu w nagłówku żądania jest nieprawidłowy lub wygasł. Typowe przyczyny Token dostępu został unieważniony. Jak postępować Poproś o nowy token. Jeśli używasz jednej z naszych bibliotek klienta, zapoznaj się z jej dokumentacją, aby dowiedzieć się, jak odświeżyć token. Wskazówki dotyczące profilaktyki Przechowuj tokeny dostępu i używaj ich ponownie, dopóki nie wygasną.
NOT_ADS_USER	Podsumowanie Konto Google użyte do wygenerowania tokena dostępu nie jest powiązane z żadnym kontem Google Ads. Typowe przyczyny Podane dane logowania odpowiadają kontu Google, na którym nie jest włączona usługa Google Ads. Jak postępować W przypadku procesu OAuth zaloguj się na prawidłowe konto Google Ads (zwykle jest to konto menedżera). Możesz też zaprosić konto Google do uzyskania dostępu do obecnego konta Google Ads. Aby to zrobić, zaloguj się na konto menedżera, wybierz odpowiednie konto klienta lub konto menedżera, kliknij Tools and Settings > Access and security, a następnie dodaj adres e-mail konta Google. Wskazówki dotyczące profilaktyki Nie dotyczy
OAUTH_TOKEN_INVALID	Podsumowanie Token dostępu OAuth w nagłówku jest nieprawidłowy. Typowe przyczyny Token dostępu przekazany w nagłówku HTTP był nieprawidłowy. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy przekazujesz prawidłowy token dostępu powiązany z Twoim kontem. Czasami jest mylony z tokenami odświeżania i kodami autoryzacji. Jeśli chcesz uzyskać dane logowania, które umożliwiają dostęp do wszystkich kont klientów na koncie menedżera, zdobądź token odświeżania dla tego konta. Zapoznaj się z przewodnikiem po uwierzytelnianiu użytkowników.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	Podsumowanie Projekt Google Cloud ma tylko dostęp testowy i nie można go używać do uzyskiwania dostępu do kont produkcyjnych. Typowe przyczyny Do wysłania żądania dotyczącego konta Google Ads, które nie jest kontem testowym (produkcyjnym), użyto projektu Google Cloud z testowym poziomem dostępu. (W wersjach interfejsu API v24 i starszych ten warunek zwraca wartość AuthorizationError.ACTION_NOT_PERMITTED). Jak postępować Jeśli testujesz, upewnij się, że żądanie jest kierowane na konto testowe. Jeśli chcesz uzyskać dostęp do produkcyjnego konta Google Ads, sprawdź poziom dostępu do projektu Google Cloud na stronie Przegląd interfejsu Google Ads API i zwiększ poziom dostępu do projektu do poziomu Eksplorator, Podstawowy lub Standardowy. Wskazówki dotyczące profilaktyki Nie dotyczy
CUSTOMER_NOT_ENABLED	Podsumowanie Nie można uzyskać dostępu do konta klienta, ponieważ nie jest ono w stanie włączonym. Typowe przyczyny Dzieje się tak, gdy rejestracja konta klienta nie została zakończona lub konto zostało wyłączone. Jak postępować Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został zakończony. W przypadku wyłączonych kont zapoznaj się z artykułem Ponowna aktywacja zlikwidowanego konta Google Ads. Wskazówki dotyczące profilaktyki Możesz aktywnie sprawdzać, czy konto klienta jest zdezaktywowane, wyszukując stan ZLIKWIDOWANE.
USER_PERMISSION_DENIED	Podsumowanie Autoryzowany klient nie ma dostępu do klienta operacyjnego. Typowe przyczyny Uwierzytelnianie jako użytkownik z dostępem do konta menedżera, ale bez określania parametru login-customer-id w żądaniu. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Jako identyfikator konta menedżera podaj login-customer-id bez łączników (-). Biblioteki klienta mają wbudowaną obsługę tej funkcji.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Podsumowanie Wartość stawki nie jest dokładną wielokrotnością minimalnej jednostki waluty konta. Na przykład 0, 015 PLN (15000 w mikrojednostkach) nie jest prawidłową stawką. Typowe przyczyny Nie dotyczy Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy stawki są wielokrotnością minimalnej jednostki waluty konta.
BID_TOO_BIG	Podsumowanie Błąd jest zwracany, mimo że stawka mieści się w budżecie kampanii. Typowe przyczyny Nie dotyczy Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy konto uczestniczy w programie Google Ad Grants. W takim przypadku ogranicz stawki CPC do maksymalnej wartości określonej w programie.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Podsumowanie Kwota budżetu jest zbyt mała. Typowe przyczyny Nie dotyczy Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy kwota budżetu jest równa minimalnej jednostce waluty konta lub od niej większa.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Podsumowanie Kwota budżetu będzie miała zbyt wiele znaczących miejsc po przecinku po przeliczeniu z mikrokwoty na kwotę w walucie konta. Typowe przyczyny Nie dotyczy Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy kwota budżetu jest podzielna przez minimalną jednostkę waluty konta.

CampaignError
DUPLICATE_CAMPAIGN_NAME	Podsumowanie Kampania jest dodawana lub zmieniana, ale nazwa jest już używana przez inną kampanię. Typowe przyczyny Utworzenie nowej kampanii o nazwie istniejącej aktywnej lub wstrzymanej kampanii. Jak postępować Zapisz błąd w dzienniku i wyświetl użytkownikowi komunikat o błędzie. Możesz też zaproponować unikalną nazwę kampanii lub wyświetlić listę używanych nazw. Wskazówki dotyczące profilaktyki Nie dotyczy
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE	Podsumowanie Próba zmiany ustawienia typu dopasowania słów kluczowych na poziomie kampanii, w której włączono AI Max. Typowe przyczyny Gdy włączysz AI Max, ustawienia dopasowania przybliżonego na poziomie kampanii zostaną wycofane z użycia, ponieważ wszystkie słowa kluczowe będą domyślnie traktowane jako dopasowanie przybliżone. Próba ustawienia lub zmodyfikowania tego pola spowoduje błąd. Jak postępować Poinformuj użytkownika, aby zamiast ustawiać dopasowanie przybliżone na poziomie kampanii, używał parametru `disable_search_term_matching` na poziomie grupy reklam. Wskazówki dotyczące profilaktyki Unikaj ustawiania wartości „BROAD” (lub innej) w parametrze `keyword_match_type` w kampanii, jeśli parametr `ai_max_setting.enable_ai_max` ma wartość „true”. Przełącz dopasowywanie wyszukiwanych słów na poziomie grupy reklam za pomocą parametru `disable_search_term_matching`.

CriterionError
KEYWORD_HAS_INVALID_CHARS	Podsumowanie dodawanie lub edytowanie słów kluczowych zawierających nieprawidłowe znaki. Typowe przyczyny Używaj w słowach kluczowych znaków specjalnych, takich jak ! @ % *. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Upewnij się, że w słowach kluczowych nie używasz niedozwolonych znaków. Zobacz Dodawanie słów kluczowych.

DistinctError
DUPLICATE_ELEMENT	Podsumowanie Żądanie zawiera 2 identyczne i zbędne parametry. Typowe przyczyny Nie dotyczy Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Przed wysłaniem żądania usuń duplikaty (operacje, parametry, elementy listy). Wyszukaj pola z ograniczeniem DistinctElements.

InternalError
DEADLINE_EXCEEDED	Podsumowanie Upłynął limit czasu żądania i nie udało się go zrealizować wystarczająco szybko, aby zwrócić odpowiedź. Typowe przyczyny Wysłano żądanie wyszukiwania, które wygenerowało zbyt dużą odpowiedź, lub żądanie modyfikacji było zbyt duże, aby można je było przetworzyć. Jak postępować Zaczekaj około 30 sekund i spróbuj jeszcze raz. Jeśli błąd nadal występuje, spróbuj podzielić żądanie na kilka mniejszych, które można szybciej zrealizować. Wskazówki dotyczące profilaktyki Zapoznaj się z sekcją Segmentacja, aby dowiedzieć się, jak może ona wpływać na rozmiar odpowiedzi. Pamiętaj o ograniczeniach warstwy transportowej gRPC.
INTERNAL_ERROR	Podsumowanie Podczas przetwarzania żądania wystąpił nieoczekiwany błąd. Typowe przyczyny Interfejs API nie działa prawidłowo z powodu błędu. Jak postępować Ponów wszystkie żądania, które zakończyły się tym błędem, korzystając z harmonogramu ponawiania ze wzrastającym czasem do ponowienia. Wskazówki dotyczące profilaktyki Nie dotyczy
TRANSIENT_ERROR	Podsumowanie Wystąpił przejściowy błąd wewnętrzny. Należy ponowić próbę. Typowe przyczyny Ten błąd występuje, gdy w interfejsie API wystąpi tymczasowy problem. Jak postępować Ponów wszystkie żądania, które zakończyły się tym błędem, korzystając z harmonogramu ponawiania ze wzrastającym czasem do ponowienia. Wskazówki dotyczące profilaktyki Nie dotyczy

InvalidGrantError

invalid_grant (malformed auth code)

Podsumowanie Kod autoryzacji wymieniony na tokeny OAuth był nieprawidłowy. Typowe przyczyny Dzieje się tak podczas próby wygenerowania tokena odświeżania dla użytkownika, który ma już przyznany dostęp do aplikacji wysyłającej żądanie. Może się to zdarzyć na przykład wtedy, gdy przykład generowania danych logowania użytkownika zostanie uruchomiony więcej niż raz w przypadku tych samych danych logowania klienta OAuth i autoryzowanego użytkownika. Jak postępować Aby ponownie wygenerować token odświeżania dla danej kombinacji użytkownika autoryzującego i danych logowania klienta OAuth, unieważnij istniejący token odświeżania. Pamiętaj, że cofnięcie tokena uniemożliwia korzystanie z niego w celu uzyskania dostępu do interfejsu Google Ads API i unieważnia wszystkie tokeny dostępu wygenerowane za pomocą tokena odświeżania. Wskazówki dotyczące profilaktyki Aby uniknąć konieczności ponownego generowania tokena odświeżania, przechowuj go w bezpiecznym miejscu.

MutateError

RESOURCE_NOT_FOUND

Podsumowanie Żądanie odnosiło się do zasobu, którego nie można było znaleźć. Typowe przyczyny Żądanie próbowało zmienić lub w inny sposób odwołać się do zasobu, który nie istnieje lub został usunięty. lub podana nazwa zasobu jest nieprawidłowa. Jak postępować Przed przesłaniem żądania modyfikacji użyj żądania wyszukiwania, aby pobrać nazwę zasobu dla istniejącego zasobu. Zapoznaj się z naszymi przewodnikami po bibliotekach klienta, które zawierają dokumentację dotyczącą tworzenia prawidłowych nazw zasobów w każdym obsługiwanym języku. Wskazówki dotyczące profilaktyki Nie twórz nazw zasobów ręcznie. Użyj jednej z metod pomocniczych oferowanych przez nasze biblioteki klienta.

NotEmptyError
EMPTY_LIST	Podsumowanie Wymagana lista jest pusta. Typowe przyczyny Przekazywanie pustej listy operacji do metody mutate. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Nie dotyczy

QuotaError
RESOURCE_EXHAUSTED	Podsumowanie Przekroczono limit częstotliwości systemowej. Typowe przyczyny Nie dotyczy Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Ustaw krótkie opóźnienia między żądaniami lub połącz więcej operacji w mniejszej liczbie żądań.

RangeError
TOO_LOW	Podsumowanie Wartość była niższa niż minimalna dozwolona. Typowe przyczyny Zapomnienie o określeniu identyfikatora, co powoduje przekazanie wartości 0. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Zwróć uwagę na ograniczenia zakresu opisane w dokumentacji interfejsu API.

RequestError
INVALID_INPUT	Podsumowanie Żądanie jest błędnie sformatowane. Typowe przyczyny Adres URL lub treść żądania są nieprawidłowe. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Nie dotyczy
REQUIRED_FIELD_MISSING	Podsumowanie W żądaniu brakuje wymaganych informacji. Typowe przyczyny Brak wymaganych pól podczas próby dodania encji. Jak postępować Zaloguj błąd i wyświetl użytkownikowi komunikat o błędzie. Atrybut fieldPath błędu wskazuje, którego pola brakuje. Wskazówki dotyczące profilaktyki Wymagane pola znajdziesz w dokumentacji interfejsu API.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Podsumowanie Żądanie próbuje utworzyć zasób, który spowodowałby przekroczenie określonego limitu łącznej liczby tych zasobów. Typowe przyczyny Istnieje wiele limitów liczby zasobów, które mogą występować w określonych kontekstach. Jak postępować Sprawdź limity systemowe, aby określić, który limit został osiągnięty. Użyj ponownie istniejącego zasobu lub usuń zasoby, aby zrobić miejsce na nowe. Wskazówki dotyczące profilaktyki Używaj zapytań, aby monitorować liczbę zasobów, które mają ograniczenia.

StringLengthError
TOO_LONG	Podsumowanie Ciąg znaków przypisany do określonego pola jest dłuższy niż limit. Typowe przyczyny Nagłówki lub teksty reklam zawierają za dużo tekstu. Jak postępować Określ limit , który został przekroczony, odpowiednio zmodyfikuj ciąg znaków i ponownie wyślij żądanie. Wskazówki dotyczące profilaktyki Pamiętaj o ograniczeniach długości ciągów znaków.