Najczęstsze błędy

Na tej stronie znajdziesz listę typowych błędów oraz wskazówki dotyczące zapobiegania im i radzenia sobie z nimi. Pełną listę błędów znajdziesz w dokumentacji błędów. Dodatkową pomoc uzyskasz na naszym forum.

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 sobie z tym radzić 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 korzysta z 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 Projekt Google Cloud Platform ze skonfigurowanym ekranem zgody OAuth dla zewnętrznego typu użytkownika i stanem publikacji Testing otrzymuje token odświeżania, który wygasa za 7 dni. Jak sobie z tym radzić 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 publikowania na In production, postępując zgodnie z tymi instrukcjami, aby uniknąć wygaśnięcia tokena odświeżania w ciągu 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 sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Po utworzeniu reklamy nie można jej modyfikować. Jeśli chcesz zmodyfikować reklamę, musisz utworzyć nową, a potem usunąć starą. status reklamy można jednak modyfikować za pomocą metody 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 sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Przed wysłaniem żądania 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 sobie z tym radzić 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ż powiązane. Jak sobie z tym radzić 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 sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Upewnij się, że 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 sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Przed wysłaniem żądania do interfejsu API sprawdź tekst słowa kluczowego w aplikacji.

AdGroupError

DUPLICATE_ADGROUP_NAME

Podsumowanie Dodawana lub zmieniana jest grupa reklam, ale 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 sobie z tym radzić Zapisz błąd i wyświetl użytkownikowi komunikat o błędzie. Możesz też zaproponować niepowtarzalną nazwę grupy reklam lub wyświetlić 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 sobie z tym radzić Utwórz komponent 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 sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki 123-456-7890 powinno być 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 podanie identyfikatora klienta w nagłówku HTTP. Jak sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Identyfikator klienta jest wymagany w przypadku wszystkich wywołań, więc upewnij się, że został on określony w nagłówku HTTP. Rozważ użycie naszych bibliotek klienta, ponieważ one zajmują się tym za Ciebie.
CUSTOMER_NOT_FOUND	Podsumowanie Nie znaleziono konta powiązanego z identyfikatorem klienta podanym w nagłówku. Typowe przyczyny Próba uzyskania dostępu do konta, które zostało utworzone dopiero niedawno, zanim zostało ono utworzone w systemie backendu. Jak sobie z tym radzić 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 sobie z tym radzić 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 i ponownie wykorzystuj tokeny dostępu, 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 sobie z tym radzić W przypadku procesu OAuth zaloguj się na prawidłowe konto Google Ads (zwykle konto menedżera). Możesz też zaprosić konto Google do korzystania z 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 potem 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 jest nieprawidłowy. Jak sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy przekazujesz prawidłowy token dostępu powiązany z Twoim kontem. Jest on czasami 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, uzyskaj token odświeżania dla konta menedżera. Więcej informacji znajdziesz w naszym przewodniku po tokenach dostępu i tokenach odświeżania oraz OAuth2.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	Podsumowanie Token dewelopera jest już powiązany z organizacją Google Cloud i nie można go powiązać z inną organizacją. Typowe przyczyny Token programisty nie jest powiązany z projektem Google Cloud w tej samej organizacji Google Cloud co projekt Google Cloud użyty do pierwotnego wysłania żądań. Jak sobie z tym radzić Jeśli masz już za sobą wywołania interfejsu API za pomocą tokena programisty, upewnij się, że identyfikator klienta OAuth jest powiązany z projektami Google Cloud w tej samej organizacji Google Cloud. Wskazówki dotyczące profilaktyki Upewnij się, że wszystkie projekty Google Cloud są powiązane z tą samą organizacją Google Cloud. Projekt Google Cloud może być powiązany tylko z 1 tokenem dewelopera, ale token dewelopera może być powiązany z wieloma projektami w organizacji.
DEVELOPER_TOKEN_INVALID	Podsumowanie Token programisty jest nieprawidłowy. Typowe przyczyny Typowe przyczyny tego błędu to literówki w tokenie dewelopera lub nieprawidłowe ustawienie tokena dewelopera w innym nagłówku żądania. Jak sobie z tym radzić Aby uniknąć błędów, skopiuj token programisty z centrum interfejsu API. Centrum interfejsu API znajdziesz na koncie menedżera Google Ads. Upewnij się też, że token dewelopera jest ustawiony w prawidłowym nagłówku. Tokeny dewelopera są czasami mylone z tokenami odświeżania OAuth i kodami autoryzacji. Więcej informacji o różnych nagłówkach żądań znajdziesz tutaj. Wskazówki dotyczące profilaktyki Nie dotyczy

AuthorizationError
CUSTOMER_NOT_ENABLED	Podsumowanie Nie można uzyskać dostępu do konta klienta, ponieważ nie jest ono włączone. Typowe przyczyny Dzieje się tak, gdy konto klienta nie zostało zarejestrowane lub zostało wyłączone. Jak sobie z tym radzić Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został zakończony. W przypadku dezaktywowanych 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 CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED	Podsumowanie Token dewelopera jest zatwierdzony tylko do użytku na kontach testowych, a użytkownik próbował uzyskać dostęp do konta innego niż testowe. Typowe przyczyny Do uzyskania dostępu do konta testowego użyto testowego tokena dewelopera. Jak sobie z tym radzić Upewnij się, że chcesz uzyskać dostęp do konta, które nie jest kontem testowym. W takim przypadku musisz złożyć wniosek o zwiększenie poziomu dostępu tokena dewelopera do poziomu Standard lub Podstawowy. Wskazówki dotyczące profilaktyki Nie dotyczy
DEVELOPER_TOKEN_PROHIBITED	Podsumowanie Token dewelopera jest niedozwolony w przypadku projektu przesłanego w żądaniu. Typowe przyczyny Każdy projekt w Konsoli interfejsów API Google może być powiązany z tokenem programisty tylko z jednego konta menedżera. Po wysłaniu żądania do interfejsu Google Ads API token programisty zostanie na stałe powiązany z projektem w Konsoli interfejsów API Google. Jeśli nie użyjesz nowego projektu w Konsoli interfejsów API Google, podczas wysyłania żądania otrzymasz błąd DEVELOPER_TOKEN_PROHIBITED. Jak sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Jeśli przechodzisz na token programisty na nowym koncie menedżera, musisz utworzyć nowy projekt w Konsoli interfejsów API Google na potrzeby żądań interfejsu Google Ads API, które używają tokena nowego menedżera.
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ślenia login-customer-id w żądaniu. Jak sobie z tym radzić 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 wielokrotnością minimalnej jednostki waluty konta. Na przykład 0, 015 USD (15000 w mikrojednostkach) to nieprawidłowa stawka. Typowe przyczyny Nie dotyczy Jak sobie z tym radzić 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 sobie z tym radzić 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 za mała. Typowe przyczyny Nie dotyczy Jak sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy kwota budżetu jest większa lub równa minimalnej jednostce waluty konta.
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 sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy kwota budżetu jest podzielna przez minimalną jednostkę w walucie konta.

CampaignError

DUPLICATE_CAMPAIGN_NAME

Podsumowanie Dodajesz lub zmieniasz nazwę kampanii, ale ta nazwa jest już używana w innej kampanii. Typowe przyczyny Utworzenie nowej kampanii o nazwie istniejącej aktywnej lub wstrzymanej kampanii. Jak sobie z tym radzić Zapisz błąd 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

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, np. ! @ % *. Jak sobie z tym radzić 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 sobie z tym radzić 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 zmiany było zbyt duże, aby można je było przetworzyć. Jak sobie z tym radzić 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 sobie z tym radzić Ponów wszystkie żądania, które zakończyły się tym błędem, korzystając z harmonogramu wzrastającego czasu do ponowienia. Wskazówki dotyczące profilaktyki Nie dotyczy
TRANSIENT_ERROR	Podsumowanie Wystąpił przejściowy błąd wewnętrzny. Spróbuj ponownie. Typowe przyczyny Ten błąd występuje, gdy w interfejsie API wystąpi tymczasowy problem. Jak sobie z tym radzić Ponów wszystkie żądania, które zakończyły się tym błędem, korzystając z harmonogramu wzrastającego czasu 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 sobie z tym radzić 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, które zostały wygenerowane przy użyciu 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 udało się 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 zniekształcona. Jak sobie z tym radzić Przed przesłaniem żądania zmiany 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 sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Nie dotyczy

QuotaError
RESOURCE_EXHAUSTED	Podsumowanie Przekroczono limit częstotliwości systemowej. Typowe przyczyny Nie dotyczy Jak sobie z tym radzić 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ż dozwolona wartość minimalna. Typowe przyczyny Zapomnienie o określeniu identyfikatora, co powoduje przekazanie wartości 0. Jak sobie z tym radzić Nie dotyczy Wskazówki dotyczące profilaktyki Zwróć uwagę na ograniczenia zakresu opisane w dokumentacji interfejsu API.

RequestError
INVALID_INPUT	Podsumowanie Żądanie jest nieprawidłowo sformatowane. Typowe przyczyny Adres URL lub treść żądania są nieprawidłowe. Jak sobie z tym radzić 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 elementu. Jak sobie z tym radzić 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 kilka limitów liczby zasobów, które mogą występować w określonych kontekstach. Jak sobie z tym radzić Sprawdź, który limit został osiągnięty, przeglądając limity systemowe. Możesz ponownie użyć istniejącego zasobu lub usunąć 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ą zbyt dużo tekstu. Jak sobie z tym radzić 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 limitach długości ciągów znaków.