Najczęstsze błędy

Na tej stronie znajdziesz listę typowych błędów oraz wskazówki dotyczące zapobiegania im i rozwiązywania problemów z nimi związanych. Pełną listę błędów znajdziesz w dokumentacji dotyczącej błędów. Aby uzyskać dodatkową pomoc, odwiedź nasze 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 obejmuje zakresu OAuth 2.0 interfejsu Google Ads API. Jak postępować w przypadku Upewnij się, że token dostępu ma wymagane zakresy. Typową przyczyną tego błędu jest ponowne użycie istniejącego tokena dostępu wygenerowanego przy użyciu innego zestawu zakresów uprawnień OAuth. Przykładowy sposób generowania nowego tokena dostępu z wymaganymi zakresami znajdziesz w sekcji Parametry autoryzacji OAuth. Wskazówki dotyczące profilaktyki Upewnij się, że token dostępu ma wymagane uprawnienia. Ponownie uwierzytelnij użytkownika z wymaganymi zakresami uprawnień, aby uzyskać dostęp z wymaganymi zakresami uprawnień. Jeśli Twoja aplikacja korzysta z kilku zakresów OAuth, konieczne może być 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 z ekranem zgody OAuth skonfigurowanym dla zewnętrznego typu użytkownika i stanem publikowania Testing otrzymuje token odświeżania, który wygasa za 7 dni. Jak postępować w przypadku Stan publikowania projektu Google to Testing, więc token odświeżania wygasa co 7 dni i otrzymuje 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, wykonując te instrukcje, aby uniknąć wygaśnięcia tokenu odświeżania po 7 dniach. Wskazówki dotyczące profilaktyki Zapoznaj się z artykułem Niezweryfikowane aplikacje.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Podsumowanie Operatora nie można używać w przypadku podklasy reklamy. Typowe przyczyny próbujesz zmodyfikować atrybuty inne niż status reklamy. Jak postępować w przypadku 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ą. Wartość status reklamy można jednak zmienić za pomocą wywołania MutateAdGroupAds.
INVALID_INPUT	Podsumowanie Jedno z polów w reklamie zawiera nieprawidłowe znaki. Typowe przyczyny Używanie znaków specjalnych w adresach URL. Jak postępować w przypadku 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 pol w reklamie było dłuższe niż maksymalna dozwolona długość. Zobacz Reklamy tekstowe. Typowe przyczyny Za długi wiersz tekstu. Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Przed wysłaniem żądania do interfejsu API sprawdź długość linii.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Podsumowanie Ta etykieta jest już powiązana z niektórymi reklamami. Typowe przyczyny Próbujesz powiązać etykietę z reklamami, które są już powiązane. Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Najpierw sprawdź, czy etykieta, którą chcesz dodać, nie jest już powiązana z reklamami.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Podsumowanie Operacja próbowała zaktualizować usunięty element. Typowe przyczyny Po usunięciu reklamy nie można jej już aktualizować, w tym zmieniać jej stanu. Jak postępować w przypadku 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 postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Przed wysłaniem żądania do interfejsu API sprawdź tekst w swojej aplikacji.

AdGroupError

DUPLICATE_ADGROUP_NAME

Podsumowanie Dodawana lub przemianowana grupa reklam ma nazwę, która 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ć w przypadku Zaloguj błąd i wyświetl komunikat o błędzie, opcjonalnie sugerując niepowtarzalną 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 z duplikowanymi operacjami tworzenia zawierającymi te same dane binarne. Jak postępować w przypadku Utwórz zasób w osobnym żądaniu, a potem połącz go w kolejnych żądaniach. Możesz też użyć 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ć w przypadku 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 Identyfikator klienta nie został podany w nagłówku HTTP. Typowe przyczyny Nieokreślony w nagłówku HTTP identyfikator klienta. Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Identyfikator klienta jest wymagany we wszystkich wywołaniach, dlatego upewnij się, że został on określony w nagłówku HTTP. Zastanów się nad skorzystaniem z naszych bibliotek klienta, które załatwią to 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 przed utworzeniem na zapleczu. Jak postępować w przypadku Odczekaj 5 minut, a następnie próbuj ponownie co 30 sekund. Wskazówki dotyczące profilaktyki Zanim wyślesz żądania dotyczące konta, odczekaj kilka minut od jego utworzenia.
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ć w przypadku 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 przechowywać i wykorzystywać tokeny dostępu do momentu ich wygaśnięcia.
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 włączono Google Ads. Jak postępować w przypadku Pamiętaj, aby zalogować się na prawidłowe konto Google Ads (zazwyczaj jest to konto menedżera) w ramach procesu OAuth. Możesz też zaprosić konto Google do uzyskania dostępu do istniejącego konta Google Ads. Aby to zrobić, zaloguj się na konto menedżera, wybierz konto klienta lub menedżera, przejdź do 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 jest nieprawidłowy. Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy został przekazany 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 podrzędnych do konta menedżera, pamiętaj, aby uzyskać token odświeżania dla tego konta menedżera. Więcej informacji znajdziesz w przewodniku na temat tokenów dostępu i tokenów 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 dewelopera nie jest powiązany z projektem Google Cloud w tej samej organizacji Google Cloud co projekt Google Cloud, z którego wysyłano pierwotne żądania. Jak postępować w przypadku Jeśli wysyłasz już żądania do 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 dewelopera jest nieprawidłowy. Typowe przyczyny Typowe przyczyny tego błędu to literówki w tokenie dewelopera lub nieprawidłowe ustawienie tokenu dewelopera w innym nagłówku żądania. Jak postępować w przypadku Aby uniknąć literówek, skopiuj token programisty z Centrum interfejsu API. Centrum interfejsu API znajdziesz na koncie menedżera Google Ads. Sprawdź też, czy token dewelopera jest ustawiany w poprawnym 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 jeszcze zarejestrowane lub zostało dezaktywowane. Jak postępować w przypadku Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został ukończony. Informacje o dezaktywowanych kontach znajdziesz w artykule Ponowna aktywacja zlikwidowanego konta Google Ads. Wskazówki dotyczące profilaktyki Możesz sprawdzić, czy konto klienta zostało zdezaktywowane, sprawdzając stan ZLIKWIDOWANE.
DEVELOPER_TOKEN_NOT_APPROVED	Podsumowanie Token dewelopera jest zatwierdzony tylko do użytku na kontach testowych, a próba uzyskania dostępu do konta, które nie jest kontem testowym, zakończyła się niepowodzeniem. Typowe przyczyny Dostęp do konta niebędącego kontem testowym uzyskano za pomocą testowego tokena dewelopera. Jak postępować w przypadku Upewnij się, że chcesz uzyskać dostęp do konta, które nie jest testowe. Jeśli tak, musisz zgłosić się o przekształcenie tokenu dewelopera w token o standardowym lub podstawowym dostępie. 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. Gdy wyślesz żądanie 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żywasz nowego projektu w Konsoli interfejsów API Google, podczas wysyłania żądania otrzymasz błąd DEVELOPER_TOKEN_PROHIBITED. Jak postępować w przypadku 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ń Google Ads API, które używają tokenu nowego menedżera.
USER_PERMISSION_DENIED	Podsumowanie Upoważniony klient nie ma dostępu do konta klienta operacyjnego. Typowe przyczyny Uwierzytelnianie jako użytkownik z dostępem do konta menedżera, ale bez podawania w żądaniu parametru login-customer-id. Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Jako identyfikator konta menedżera podaj wartość login-customer-id bez myślników (-). Biblioteki klienta mają wbudowane odpowiednie funkcje.

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 mikrodolarach) nie jest prawidłową stawką. Typowe przyczyny Nie dotyczy Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy stawki są wielokrotnością minimalnej jednostki waluty na koncie.
BID_TOO_BIG	Podsumowanie Ten błąd jest zwracany, mimo że stawka mieści się w budżecie kampanii. Typowe przyczyny Nie dotyczy Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy konto bierze udział w programie Google Ad Grants. W takim przypadku ogranicz stawki CPC do maksimum określonego przez program.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Podsumowanie Kwota budżetu jest za mała. Typowe przyczyny Nie dotyczy Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy kwota budżetu jest równa lub większa niż minimalna jednostka waluty na koncie.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Podsumowanie Po przekształceniu z mikrokwoty na kwotę w walucie konta kwota budżetu będzie miała zbyt wiele miejsc po przecinku. Typowe przyczyny Nie dotyczy Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Sprawdź, czy kwota budżetu jest podzielna przez minimalną jednostkę waluty na koncie.

CampaignError

DUPLICATE_CAMPAIGN_NAME

Podsumowanie Dodawana lub przemianowana kampania ma nazwę, która jest już używana przez inną kampanię. Typowe przyczyny utworzyć nową kampanię o nazwie istniejącej aktywnej lub wstrzymanej kampanii; Jak postępować w przypadku Zarejestruj błąd i wyświetl komunikat o błędzie, opcjonalnie sugerują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 Używanie w słowach kluczowych znaków specjalnych, np. ! @ % *. Jak postępować w przypadku 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 parametry, które są identyczne i niepotrzebne. Typowe przyczyny Nie dotyczy Jak postępować w przypadku 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 Upłynął limit czasu żądania i nie udało się go zrealizować na tyle szybko, aby zdążyć z odpowiedzią. Typowe przyczyny przesłano żądanie wyszukiwania, które wygenerowało zbyt dużą odpowiedź lub żądanie modyfikacji było zbyt duże do przetworzenia; Jak postępować w przypadku Zaczekaj około 30 sekund i spróbuj jeszcze raz. Jeśli błąd się powtarza, spróbuj podzielić żądanie na kilka mniejszych, które można wykonać szybciej. Wskazówki dotyczące profilaktyki Zapoznaj się z informacjami na temat segmentacji, aby zrozumieć, 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ć w przypadku Ponownie wysyłaj żądania, które zakończyły się niepowodzeniem z tym błędem, używając do ponownych prób algorytmu wzrastającego czasu do ponowienia. Wskazówki dotyczące profilaktyki Nie dotyczy
TRANSIENT_ERROR	Podsumowanie Wystąpił przejściowy błąd wewnętrzny. Należy spróbować ponownie. Typowe przyczyny Ten błąd występuje, gdy interfejs API napotka tymczasowy problem wewnętrzny. Jak postępować w przypadku Ponownie wysyłaj żądania, które zakończyły się niepowodzeniem z tym błędem, używając do ponownych prób algorytmu 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, gdy próbujesz wygenerować token odświeżania dla użytkownika, który ma już dostęp do aplikacji przesyłającej żądanie. Może się tak zdarzyć, gdy przykład generowania danych uwierzytelniających użytkownika zostanie uruchomiony więcej niż raz z użyciem tych samych danych klienta OAuth i użytkownika upoważniającego. Jak postępować w przypadku Aby wygenerować token odświeżania dla danej kombinacji danych logowania użytkownika i klienta OAuth, unieważnij dotychczasowy token odświeżania. Pamiętaj, że cofnięcie tokenu powoduje, że nie można go używać do uzyskiwania dostępu do interfejsu Google Ads API, a tokeny dostępu wygenerowane przy użyciu tokenu odświeżania tracą ważność. Wskazówki dotyczące profilaktyki Aby uniknąć konieczności odtwarzania, przechowuj token odświeżania w bezpiecznym miejscu.

MutateError

RESOURCE_NOT_FOUND

Podsumowanie Żądanie odnosiło się do zasobu, którego nie udało się znaleźć. Typowe przyczyny W żądaniu nastąpiła próba zmodyfikowania zasobu, który nie istnieje lub został usunięty, lub odwołania się do niego. Może też być tak, że podana nazwa zasobu jest zniekształcona. Jak postępować w przypadku Zanim prześlesz żądanie zmodyfikowania zasobu, użyj zapytania wyszukiwania, aby pobrać nazwę istniejącego zasobu. Zapoznaj się z przewodnikiem biblioteki klienta, który zawiera dokumentację na temat tworzenia prawidłowych nazw zasobów we wszystkich obsługiwanych językach. 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ć w przypadku 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ć w przypadku 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 postępować w przypadku 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 ma nieprawidłowy format. Jak postępować w przypadku Nie dotyczy Wskazówki dotyczące profilaktyki Nie dotyczy
REQUIRED_FIELD_MISSING	Podsumowanie W prośbie brakuje wymaganych informacji. Typowe przyczyny Brak wymaganych pól podczas próby dodania encji. Jak postępować w przypadku Zarejestruj 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 Aby dowiedzieć się, które pola są wymagane, zapoznaj się z dokumentacją interfejsu API.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Podsumowanie Żądanie próbuje utworzyć zasób, który spowodowałby przekroczenie określonego limitu. Typowe przyczyny Liczba zasobów, które mogą występować w określonych kontekstach, jest ograniczona. Jak postępować w przypadku Sprawdź, który limit jest osiągany, przeglądając ograniczenia systemu. Użyj istniejącego zasobu lub usuń zasoby, aby zrobić miejsce na nowe. Wskazówki dotyczące profilaktyki Za pomocą zapytań wyszukiwania możesz sprawdzać liczbę zasobów, które mają ograniczenia.

StringLengthError
TOO_LONG	Podsumowanie Ciąg znaków przypisany do wybranego pola jest dłuższy niż dozwolony limit. Typowe przyczyny Nagłówki lub teksty reklamy zawierają zbyt dużo tekstu. Jak postępować w przypadku 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ągu znaków.