Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie znajdziesz listę częstych 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. 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 z ekranem zgody OAuth skonfigurowanym pod kątem użytkownika zewnętrznego i stanem publikowania Testing zostanie wystawiony token odświeżania, który wygasa za 7 dni.
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 publikowania na In production, postępując zgodnie z tymi instrukcjami, aby token odświeżania nie mógł wygasnąć za 7 dni.
Tego operatora nie można używać z podklasą reklamy.
Typowe przyczyny
Próbujesz zmienić atrybuty inne niż status reklamy.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Po utworzeniu reklamy nie można jej modyfikować. Aby zmienić reklamę, musisz utworzyć nową reklamę i usunąć starą. status reklamy można jednak zmienić za pomocą elementu 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
Zweryfikuj adresy URL w aplikacji przed wysłaniem żądania do interfejsu API.
LINE_TOO_WIDE
Podsumowanie
Jedno z pól w reklamie przekraczał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
Sprawdź długość wiersza przed wysłaniem żądania do API.
123-456-7890 powinien mieć postać 1234567890. Więcej informacji znajdziesz w artykule Pierwsze kroki.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Podsumowanie
Identyfikator klienta klienta nie został określony w nagłówku HTTP.
Typowe przyczyny
Nie określono identyfikatora klienta klienta w nagłówku HTTP.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Identyfikator klienta klienta jest wymagany we wszystkich wywołaniach, więc pamiętaj, by podać go w nagłówku HTTP. Rozważ skorzystanie z naszych bibliotek klienta, ponieważ robią to za Ciebie.
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 utworzeniem konta w backendzie.
Jak postępować
Zaczekaj 5 minut, a potem spróbuj ponownie co 30 sekund.
Wskazówki dotyczące profilaktyki
Po utworzeniu konta odczekaj kilka minut, zanim wyślesz prośby.
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 klienckich, zapoznaj się z jej dokumentacją, aby dowiedzieć się, jak odświeżyć token.
Wskazówki dotyczące profilaktyki
Przechowywanie i ponowne używanie tokenów 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 informacje logowania odpowiadają kontu Google, na którym nie włączono Google Ads.
Jak postępować
Pamiętaj, aby zalogować się na prawidłowe konto Google Ads (zwykle jest to konto menedżera) na potrzeby procesu OAuth. Możesz też zezwolić kontu Google na dostęp do istniejącego konta Google Ads. Aby to zrobić, zaloguj się na konto menedżera, wybierz odpowiednie konto klienta lub menedżera, otwórz 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 nie był prawidłowy.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Sprawdź, czy przekazać właściwy token dostępu powiązany z Twoim kontem. Jest czasami mylony z tokenami odświeżania i kodami autoryzacji. Jeśli chcesz uzyskać dane logowania umożliwiające dostęp do wszystkich kont klientów w ramach konta menedżera, pobierz token odświeżania konta menedżera. Więcej informacji znajdziesz w naszym przewodniku po tokenach dostępu i tokenach odświeżania oraz OAuth2.
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 zakończone lub zostało zdezaktywowane.
Jak postępować
Zaloguj się w interfejsie Google Ads i upewnij się, że ukończono proces rejestracji tego konta. Informacje na temat dezaktywowanych kont znajdziesz w artykule Ponowna aktywacja zlikwidowanego konta Google Ads.
Wskazówki dotyczące profilaktyki
Możesz proaktywnie sprawdzić, czy konto klienta zostało zdezaktywowane, sprawdzając stan ANULOWANE.
DEVELOPER_TOKEN_NOT_APPROVED
Podsumowanie
Token programisty jest zatwierdzony tylko do użytku z kontami testowymi i próba uzyskania dostępu do konta innego niż testowy.
Typowe przyczyny
Do uzyskania dostępu do konta innego niż test został użyty testowy token programisty.
Token programisty jest niedozwolony w projekcie wysłanym 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 jest trwale sparowany 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 pojawi się błąd DEVELOPER_TOKEN_PROHIBITED.
Jak postępować
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
Autoryzowany klient nie ma dostępu do działającego klienta.
Typowe przyczyny
Uwierzytelnianie jako użytkownik z dostępem do konta menedżera, ale bez określenia login-customer-id w żądaniu.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Podaj login-customer-id jako identyfikator konta menedżera bez łączników (-). Biblioteki klienta mają wbudowaną obsługę tej funkcji.
Żądanie przekroczyło limit czasu i nie mogło zostać wykonane wystarczająco szybko, by zwrócić odpowiedź.
Typowe przyczyny
Przesłano żądanie wyszukiwania, które wygenerowało zbyt dużą odpowiedź lub żądanie zmiany 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 żądań, które można szybciej zrealizować.
Podczas przetwarzania żądania wystąpił nieoczekiwany błąd.
Typowe przyczyny
Z powodu błędu interfejs API nie działa prawidłowo.
Jak postępować
Ponów wszystkie żądania, których nie udało się zrealizować z powodu tego błędu, przy użyciu wykładniczego harmonogramu wycofywania dla ponownych prób.
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 występuje, gdy interfejs API wewnętrznie napotka tymczasowy problem.
Jak postępować
Ponów wszystkie żądania, których nie udało się zrealizować z powodu tego błędu, przy użyciu wykładniczego harmonogramu wycofywania dla ponownych prób.
Wskazówki dotyczące profilaktyki
Nie dotyczy
InvalidGrantError
invalid_grant (malformed auth code)
Podsumowanie
Kod autoryzacji wymieniony na tokeny OAuth miał nieprawidłowy format.
Typowe przyczyny
Dzieje się tak podczas próby wygenerowania tokena odświeżania dla użytkownika, który otrzymał już dostęp do żądanej aplikacji. Może się tak zdarzyć w przypadku wykonania przykładu generowania danych logowania użytkownika więcej niż raz dla tych samych danych logowania klienta OAuth i autoryzowania użytkownika.
Jak postępować
Aby ponownie wygenerować token odświeżania dla danej kombinacji autoryzacji użytkownika i danych klienta OAuth, unieważnij istniejący token odświeżania. Pamiętaj, że unieważnienie tokena uniemożliwia dostęp do niego do interfejsu API Google Ads i powoduje unieważnienie wszystkich tokenów dostępu użytych do wygenerowania tokena odświeżania.
Wskazówki dotyczące profilaktyki
Przechowuj token odświeżania w bezpiecznej lokalizacji, by uniknąć jego ponownego generowania.
Żądanie odnosiło się do zasobu, którego nie udało się znaleźć.
Typowe przyczyny
W żądaniu podjęto próbę zmiany zasobu lub odwołania do zasobu, który nie istnieje lub został usunięty. Możliwe też, że podana nazwa zasobu dla zasobu jest nieprawidłowa.
Jak postępować
Przed wysłaniem żądania zmiany możesz pobrać nazwę istniejącego zasobu za pomocą żądania wyszukiwania. Zapoznaj się z naszymi przewodnikami po bibliotece 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 ręcznie nazw zasobów. Użyj jednej z metod pomocniczych oferowanych przez nasze biblioteki klienta.
Żądanie próbuje utworzyć zasób, który spowodowałby przekroczenie określonego limitu przez łączną liczbę tych zasobów.
Typowe przyczyny
Istnieje wiele ograniczeń liczby zasobów, które mogą istnieć w określonych kontekstach.
Jak postępować
Aby dowiedzieć się, jaki limit występuje, przeczytaj artykuł Limity systemu. Możesz ponownie wykorzystać istniejący zasób lub usunąć zasoby, aby utworzyć miejsce dla nowych.
Wskazówki dotyczące profilaktyki
Za pomocą zapytań możesz sprawdzać liczbę zasobów, które są objęte ograniczeniami.