Najczęstsze błędy

Na tej stronie znajdziesz listę typowych błędów oraz wskazówki dotyczące ich zapobiegania i eliminowania z nich. Pełną listę błędów znajdziesz w dokumentacji błędów. Dodatkową pomoc znajdziesz na naszym forum.

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 skonfigurowanym dla użytkownika zewnętrznego i stanem publikowania Testing zostanie wydany token odświeżania, który wygaśnie za 7 dni. Jak obsługiwać Stan publikowania Twojego projektu Google to Testing, dlatego token odświeżania wygasa co 7 dni i pojawia się błąd invalid_grant. Otwórz Konsolę interfejsów API Google i przejdź do ekranu zgody OAuth. Następnie zmień stan publikowania na In production, postępując zgodnie z tymi instrukcjami, 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ą reklamy. Typowe przyczyny Próbujesz zmienić atrybuty inne niż status reklamy. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Utworzonej reklamy nie można już modyfikować. Aby zmodyfikować reklamę, musisz utworzyć nową reklamę i usunąć starą. Element status reklamy można jednak zmienić za pomocą klasy MutateAdGroupAds.
INVALID_INPUT	Podsumowanie Jedno z pól reklamy zawiera nieprawidłowe znaki. Typowe przyczyny Używanie znaków specjalnych w adresach URL. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Zweryfikuj adresy URL w aplikacji przed wysłaniem żądania do interfejsu API.
LINE_TOO_WIDE	Podsumowanie Jedno z pól reklamy przekraczało maksymalną dozwoloną długość. Więcej informacji znajdziesz w artykule Informacje o reklamach tekstowych. Typowe przyczyny Zbyt długi wiersz tekstu. Jak obsługiwać 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 zostały już powiązane. Jak obsługiwać 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 Operacja próbowała zaktualizować usuniętą reklamę. Typowe przyczyny Usuniętej reklamy nie można już aktualizować (dotyczy to też zmiany stanu). Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Upewnij się, że Twój 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 obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Zweryfikuj tekst słowa kluczowego w aplikacji przed wysłaniem żądania do interfejsu API.

AdGroupError

DUPLICATE_ADGROUP_NAME

Podsumowanie Trwa dodawanie lub zmiana nazwy grupy reklam, ale ta nazwa jest już używana przez inną grupę reklam. Typowe przyczyny Tworzenie nowej grupy reklam o nazwie istniejącej już aktywnej lub wstrzymanej grupy reklam. Jak obsługiwać Zarejestruj błąd i wyświetl komunikat o błędzie, opcjonalnie wskaż unikalną nazwę grupy reklam lub listę używanych nazw. Wskazówki dotyczące profilaktyki Nie dotyczy

AssetError

DUPLICATE_ASSET

Podsumowanie Dwie operacje w jednym żądaniu zawierają operację tworzenia zasobu z tymi samymi danymi binarnymi. Typowe przyczyny Żądanie mutacji ze zduplikowanymi operacjami tworzenia zawierających te same dane binarne. Jak obsługiwać Utwórz komponent w osobnej prośbie, a potem połącz go z nim w kolejnej prośbie. Możesz też w tej samej prośbie użyć tymczasowego identyfikatora. Wskazówki dotyczące profilaktyki Nie dotyczy

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Podsumowanie Identyfikator klienta nie jest liczbą. Typowe przyczyny Użycie niewłaściwego identyfikatora klienta. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Numer 123-456-7890 powinien być taki sam jak 1234567890. Więcej informacji znajdziesz w artykule Pierwsze kroki.
CLIENT_CUSTOMER_ID_IS_REQUIRED	Podsumowanie Identyfikator klienta nie został podany w nagłówku HTTP. Typowe przyczyny Nieokreślenie identyfikatora klienta w nagłówku HTTP. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Identyfikator klienta jest wymagany we wszystkich wywołaniach, więc musisz go podać w nagłówku HTTP. Rozważ skorzystanie z naszych bibliotek klienta, które obsługują tę funkcję.
CUSTOMER_NOT_FOUND	Podsumowanie Nie znaleziono konta dla identyfikatora klienta podanego w nagłówku. Typowe przyczyny Próbujesz uzyskać dostęp do konta, które zostało właśnie utworzone przed założeniem konta w backendzie. Jak obsługiwać Odczekaj pierwsze 5 minut, a potem ponawiaj próby co 30 sekund. Wskazówki dotyczące profilaktyki Odczekaj kilka minut po utworzeniu konta, zanim wyślesz do niego prośby.
GOOGLE_ACCOUNT_COOKIE_INVALID	Podsumowanie Token dostępu w nagłówku żądania jest nieprawidłowy lub stracił ważność. Typowe przyczyny Token dostępu został unieważniony. Jak obsługiwać 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 stracą ważności.
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 informacje logowania odpowiadają kontu Google, na którym nie włączono Google Ads. Jak obsługiwać Pamiętaj, aby zalogować się na prawidłowe konto Google Ads (zwykle na konto menedżera) w celu obsługi protokołu OAuth. Możesz też zaprosić konto Google do korzystania z istniejącego konta Google Ads. Aby to zrobić, zaloguj się na konto menedżera, wybierz odpowiednie konto klienta lub menedżera, otwórz stronę Tools and Settings > Access and security i 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 z nagłówkiem HTTP jest nieprawidłowy. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Upewnij się, że przekazano prawidłowy token dostępu powiązany z kontem. Czasem jest mylony z tokenami odświeżania i kodami autoryzacji. Jeśli chcesz uzyskać dane logowania, które dają dostęp do wszystkich kont klientów w ramach konta menedżera, uzyskaj token odświeżania konta menedżera. Więcej informacji znajdziesz w przewodniku po tokenie dostępu i tokenie odświeżania oraz OAuth2.

AuthorizationError
CUSTOMER_NOT_ENABLED	Podsumowanie Nie można uzyskać dostępu do konta klienta, ponieważ nie zostało ono włączone. Typowe przyczyny Dzieje się tak, gdy konto klienta nie zakończyło się rejestracji lub zostało zdezaktywowane. Jak obsługiwać Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został ukończony. Informacje na temat zdezaktywowanych kont znajdziesz w artykule Ponowna aktywacja zlikwidowanego konta Google Ads. Wskazówki dotyczące profilaktyki Możesz z wyprzedzeniem sprawdzić, czy konto klienta jest dezaktywowane, sprawdzając stan ANULOWANO.
DEVELOPER_TOKEN_NOT_APPROVED	Podsumowanie Token programisty jest zatwierdzony do użycia tylko z kontami testowymi i próbuje uzyskać dostęp do konta innego niż testowe. Typowe przyczyny Użyto testowego tokena programisty, aby uzyskać dostęp do konta innego niż testowe. Jak obsługiwać Upewnij się, że faktycznie chcesz uzyskać dostęp do konta innego niż testowe. Jeśli tak, musisz poprosić o zmianę tokena programisty na dostęp standardowy lub podstawowy. Wskazówki dotyczące profilaktyki Nie dotyczy
DEVELOPER_TOKEN_PROHIBITED	Podsumowanie W projekcie wysłanym w żądaniu nie można używać tokena programisty. Typowe przyczyny Każdy projekt Konsoli interfejsów API Google można powiązać z tokenem programisty tylko z jednego konta menedżera. Po wysłaniu żądania do interfejsu Google Ads API token programisty zostaje trwale powiązany z projektem w Konsoli interfejsów API Google. Jeśli nie używasz nowego projektu w Konsoli interfejsów API Google, podczas wysyłania żądania wystąpi błąd DEVELOPER_TOKEN_PROHIBITED. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Jeśli przechodzisz na token programisty na nowym koncie menedżera, musisz utworzyć nowy projekt Konsoli interfejsów API Google dla żądań do interfejsu Google Ads API, które korzystają z tokena nowego menedżera.
USER_PERMISSION_DENIED	Podsumowanie Upoważniony klient nie ma dostępu do klienta operacyjnego. Typowe przyczyny Uwierzytelnianie jako użytkownik z dostępem do konta menedżera bez określania adresu login-customer-id w żądaniu. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Podaj login-customer-id jako identyfikator konta menedżera bez łączników (-). Biblioteki klienta udostępniają tę funkcję.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Podsumowanie Wartość stawki nie jest wielokrotnością minimalnej jednostki waluty konta. Na przykład 0, 015 zł (15000 w mikro) nie jest prawidłową stawką. Typowe przyczyny Nie dotyczy Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy stawki są wielokrotnością minimalnej jednostki dla 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 obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy konto uczestniczy w programie Google Ad Grants. Jeśli tak, 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 obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy kwota budżetu jest większa od minimalnej jednostki dla waluty konta lub jej równa.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Podsumowanie Kwota budżetu będzie zawierać zbyt wiele istotnych miejsc po przecinku przy przeliczaniu z kwoty mikro na kwotę w walucie konta. Typowe przyczyny Nie dotyczy Jak obsługiwać 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 zmienia nazwę, ale ta nazwa jest już używana przez inną kampanię. Typowe przyczyny Tworzenie nowej kampanii o nazwie istniejącej już aktywnej lub wstrzymanej kampanii. Jak obsługiwać Zarejestruj błąd i wyświetl komunikat o błędzie, opcjonalnie zasugerowając unikalną nazwę kampanii lub wyświetlając listę używanych nazw. Wskazówki dotyczące profilaktyki Nie dotyczy

CriterionError
KEYWORD_HAS_INVALID_CHARS	Podsumowanie Dodawanie lub edytowanie słów kluczowych zawierających nieprawidłowe znaki. Typowe przyczyny W słowach kluczowych używaj znaków specjalnych, np. ! @ % *. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Upewnij się, że słowa kluczowe nie zawierają niedozwolonych znaków. Zobacz Dodawanie słów kluczowych.

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

InternalError
DEADLINE_EXCEEDED	Podsumowanie Żądanie przekroczyło limit czasu i nie mogło zostać wykonane wystarczająco szybko, by zwrócić odpowiedź. Typowe przyczyny Wysłano żądanie wyszukiwania, które wygenerowało zbyt dużą odpowiedź lub żądanie mutacji było zbyt duże, aby można było je przetworzyć. Jak obsługiwać Zaczekaj około 30 sekund i spróbuj jeszcze raz. Jeśli błąd będzie się powtarzał, spróbuj podzielić żądanie na kilka mniejszych żądań, które można realizować szybciej. Wskazówki dotyczące profilaktyki Sprawdź segmentację, aby dowiedzieć się, jak może wpływać na rozmiar odpowiedzi. Pamiętaj o ograniczeniach warstwy transportu 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 obsługiwać Ponów próbę wszystkich żądań, które zakończyły się tym błędem, stosując dla ponownych prób rosnący wykładniczy harmonogram. Wskazówki dotyczące profilaktyki Nie dotyczy
TRANSIENT_ERROR	Podsumowanie Wystąpił tymczasowy błąd wewnętrzny. Spróbuj ponownie. Typowe przyczyny Ten błąd występuje, gdy interfejs API napotyka wewnętrzny problem tymczasowy. Jak obsługiwać Ponów próbę wszystkich żądań, które zakończyły się tym błędem, stosując dla ponownych prób rosnący wykładniczy harmonogram. Wskazówki dotyczące profilaktyki Nie dotyczy

InvalidGrantError

invalid_grant (malformed auth code)

Podsumowanie Kod autoryzacji wymieniany na tokeny OAuth miał nieprawidłowy format. Typowe przyczyny Dzieje się tak, gdy próbujesz wygenerować token odświeżania dla użytkownika, który ma już przyznany dostęp do aplikacji wysyłającej żądanie. Może się tak na przykład zdarzyć, gdy przykładowe dane logowania użytkownika Generuj dane użytkownika zostaną uruchomione więcej niż raz dla tych samych danych logowania klienta OAuth i autoryzowanego użytkownika. Jak obsługiwać Aby ponownie wygenerować token odświeżania dla danej kombinacji danych logowania użytkownika i klienta OAuth, unieważnij istniejący token odświeżania. Pamiętaj, że unieważnienie tokena powoduje, że nie można go używać do uzyskiwania dostępu do interfejsu Google Ads API, a tokeny dostępu, które zostały wygenerowane przy użyciu tego tokena odświeżania, unieważniają. Wskazówki dotyczące profilaktyki Pamiętaj, aby przechowywać token odświeżania w bezpiecznej lokalizacji, aby nie trzeba było go ponownie generować.

MutateError

RESOURCE_NOT_FOUND

Podsumowanie Żądanie odnosiło się do zasobu, którego nie można znaleźć. Typowe przyczyny W żądaniu próbowano dokonać mutacji lub w inny sposób odwoływać się do zasobu, który nie istnieje lub został usunięty. Możliwe też, że podana nazwa zasobu ma nieprawidłowy format. Jak obsługiwać Przed przesłaniem żądania mutacji użyj żądania wyszukiwania, aby pobrać nazwę istniejącego zasobu. Zapoznaj się z przewodnikami po bibliotece klientów, które zawierają dokumentację tworzenia prawidłowych nazw zasobów w każdym obsługiwanym języku Wskazówki dotyczące profilaktyki Nie twórz ręcznie nazw zasobów. Skorzystaj z jednej z metod pomocniczych dostępnych w naszych bibliotekach klienta.

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

QuotaError
RESOURCE_EXHAUSTED	Podsumowanie Systemowy limit częstotliwości został przekroczony. Typowe przyczyny Nie dotyczy Jak obsługiwać 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ż dopuszczalne minimum. Typowe przyczyny Zapomnienie określenia identyfikatora powoduje przekazanie wartości 0. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Pamiętaj o ograniczeniach zakresów opisanych w dokumentacji interfejsu API.

RequestError
INVALID_INPUT	Podsumowanie Żądanie jest uszkodzone. Typowe przyczyny Adres URL lub treść żądania są uszkodzone. Jak obsługiwać Nie dotyczy Wskazówki dotyczące profilaktyki Nie dotyczy
REQUIRED_FIELD_MISSING	Podsumowanie W żądaniu brakuje wymaganych informacji. Typowe przyczyny Brakuje wymaganych pól podczas próby dodania elementu. Jak obsługiwać Zapisz 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 Sprawdź w dokumentacji interfejsu API, które pola są wymagane.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Podsumowanie Żądanie próbuje utworzyć zasób, który spowodowałby przekroczenie łącznej liczby tych zasobów. Typowe przyczyny Istnieje wiele ograniczeń liczby zasobów, które mogą istnieć w poszczególnych kontekstach. Jak obsługiwać Aby określić, na czym polega problem, sprawdź Limity systemu. Ponownie użyj istniejącego zasobu lub usuń zasoby, aby zwolnić miejsce na nowe. Wskazówki dotyczące profilaktyki Aby monitorować liczbę zasobów, które są objęte ograniczeniami, użyj zapytań.

StringLengthError
TOO_LONG	Podsumowanie Ciąg znaków przypisany do określonego pola przekracza limit. Typowe przyczyny Nagłówki lub teksty reklam zawierają za dużo tekstu. Jak obsługiwać Określ napotkany limit, odpowiednio zmodyfikuj ciąg znaków i ponownie wyślij żądanie. Wskazówki dotyczące profilaktyki Pamiętaj o limitach długości ciągu znaków.