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 protokołu 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 Upewnij się, że 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 Projekt Google Cloud Platform z ekranem zgody OAuth skonfigurowanym dla zewnętrznego typu użytkownika i stanem publikacji Testing otrzymuje token odświeżania, który wygasa po 7 dniach. Jak postępować Stan publikacji Twojego projektu Google to Testing, więc 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 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óba zmiany atrybutów innych 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 zmienić 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 postępować 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 przekroczyło maksymalną dozwoloną długość. Więcej informacji znajdziesz w artykule 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 Operacja próbowała zaktualizować usuniętą reklamę. 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 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ć 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 grupę reklam lub zmieniasz jej nazwę, ale nazwa jest już używana przez inną grupę reklam. Typowe przyczyny utworzenie 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 Dwie operacje w jednym żądaniu zawierają operację utworzenia komponentu z tymi samymi danymi binarnymi. Typowe przyczyny Żądanie modyfikacji z duplikatami operacji tworzenia zawierającymi te same dane binarne. Jak postępować 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żywasz nieprawidłowego identyfikatora klienta, Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki 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 we wszystkich wywołaniach, więc upewnij się, że został 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 o identyfikatorze klienta podanym w nagłówku. Typowe przyczyny Próba uzyskania dostępu do konta, które zostało właśnie utworzone, zanim zostanie ono skonfigurowane w backendzie. Jak postępować Odczekaj 5 minut, a następnie ponawiaj próbę 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 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 postępować Pamiętaj, aby zalogować się na prawidłowe konto Google Ads (zwykle konto menedżera) w celu przeprowadzenia procesu OAuth. 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 Upewnij się, że 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, upewnij się, że masz token odświeżania dla konta menedżera. 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 do konta Google Ads innego niż testowe (produkcyjnego) użyto projektu Google Cloud z poziomem dostępu testowego. (W interfejsie API w wersji 24 i starszych ten warunek zwraca wartość AuthorizationError.ACTION_NOT_PERMITTED). Jak postępować Jeśli przeprowadzasz testy, 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 uaktualnij poziom dostępu do projektu do poziomu Explorer, Basic lub Standard. 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 konto klienta nie zostało zarejestrowane lub 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 podawania w żądaniu parametru login-customer-id. 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 USD (15000 w mikrokwotach) 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. Jeśli tak jest, 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 Dodajesz kampanię lub zmieniasz jej nazwę, 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ć Zarejestruj błąd i wyświetl użytkownikowi 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
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE	Podsumowanie Próba zmiany ustawienia typu dopasowania słów kluczowych na poziomie kampanii w kampanii z włączonym AI Max. Typowe przyczyny Po włączeniu funkcji AI Max ustawienia dopasowania przybliżonego na poziomie kampanii są wycofywane, ponieważ wszystkie słowa kluczowe są domyślnie traktowane jako słowa kluczowe w dopasowaniu przybliżonym. Próba ustawienia lub zmodyfikowania tego pola spowoduje błąd. Jak postępować Poradź użytkownikowi, aby używał parametru `disable_search_term_matching` na poziomie grupy reklam, zamiast ustawiać dopasowanie przybliżone na poziomie kampanii. 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łączaj 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żywać 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). Znajdź 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 Zostało wysłane żądanie wyszukiwania, które wygenerowało zbyt dużą odpowiedź, lub żądanie modyfikacji było zbyt duże, aby można było je przetworzyć. Jak postępować 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, 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 i należy ponowić próbę. Typowe przyczyny Ten błąd pojawia się, gdy w interfejsie API wystąpi tymczasowy problem wewnętrzny. 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ę tak zdarzyć na przykład wtedy, gdy uruchomisz przykład generowania danych logowania użytkownika więcej niż raz dla tych samych danych logowania klienta OAuth i autoryzującego 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 unieważnienie tokena uniemożliwia korzystanie z niego do uzyskiwania dostępu do interfejsu Google Ads API i powoduje unieważnienie wszystkich tokenów dostępu, które zostały wygenerowane za pomocą tego tokena odświeżania. Wskazówki dotyczące profilaktyki Pamiętaj, aby przechowywać token odświeżania w bezpiecznym miejscu, aby uniknąć konieczności jego ponownego generowania.

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 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 przewodnikami po bibliotekach klienta, które zawierają dokumentację dotyczącą 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 Przekazanie 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 systemu. 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 API.

RequestError
INVALID_INPUT	Podsumowanie Żądanie jest błędnie sformatowane. Typowe przyczyny Adres URL lub treść żądania są nieprawidłowo sformatowane. Jak postępować Nie dotyczy Wskazówki dotyczące profilaktyki Nie dotyczy
REQUIRED_FIELD_MISSING	Podsumowanie W żądaniu brakuje wymaganych informacji. Typowe przyczyny Podczas próby dodania encji brakuje wymaganych pól. Jak postępować 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 łą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 dowiedzieć się, 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 sprawdzać 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ć Sprawdź , który limit 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.