Najczęstsze błędy

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
PodsumowanieToken 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.
Wskazówki dotyczące profilaktyki Zobacz Niezweryfikowane aplikacje.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
PodsumowanieIdentyfikator klienta nie jest liczbą.
Typowe przyczyny Używanie nieprawidłowego identyfikatora klienta.
Jak postępować Nie dotyczy
Wskazówki dotyczące profilaktyki 123-456-7890 powinien mieć postać 1234567890. Więcej informacji znajdziesz w artykule Pierwsze kroki.
CLIENT_CUSTOMER_ID_IS_REQUIRED
PodsumowanieIdentyfikator 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
PodsumowanieNie 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.
PodsumowanieToken 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
PodsumowanieKonto 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
PodsumowanieToken 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.

AuthorizationError

CUSTOMER_NOT_ENABLED
PodsumowanieNie 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
PodsumowanieToken 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.
Jak postępować Upewnij się, że chcesz uzyskać dostęp do konta innego niż testowe. Jeśli tak, musisz złożyć wniosek o uaktualnienie tokena programisty na dostęp standardowy lub podstawowy.
Wskazówki dotyczące profilaktyki Nie dotyczy
DEVELOPER_TOKEN_PROHIBITED
PodsumowanieToken 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
PodsumowanieAutoryzowany 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.