Najczęstsze błędy

Na tej stronie znajdziesz listę typowych błędów oraz wskazówki dotyczące ich zapobiegania i eliminowania z nich. 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 ze skonfigurowanym ekranem zgody OAuth skonfigurowanym dla użytkownika zewnętrznego i stanem publikowania Testing zostanie wydany token odświeżania, który wygaśnie za 7 dni.
Jak obsługiwać Stan publikowania Twojego projektu Google to Testing, dlatego 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 uniknąć wygaśnięcia tokena odświeżania za 7 dni.
Wskazówki dotyczące profilaktyki Zobacz Niezweryfikowane aplikacje.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
PodsumowanieIdentyfikator klienta nie jest liczbą.
Typowe przyczyny Użycie niewłaściwego identyfikatora klienta.
Jak obsługiwać Nie dotyczy
Wskazówki dotyczące profilaktyki Numer 123-456-7890 powinien być taki sam jak 1234567890. Więcej informacji znajdziesz w artykule Pierwsze kroki.
CLIENT_CUSTOMER_ID_IS_REQUIRED
PodsumowanieIdentyfikator klienta nie został podany w nagłówku HTTP.
Typowe przyczyny Nieokreślenie identyfikatora klienta w nagłówku HTTP.
Jak obsługiwać Nie dotyczy
Wskazówki dotyczące profilaktyki Identyfikator klienta jest wymagany we wszystkich wywołaniach, więc musisz go podać w nagłówku HTTP. Rozważ skorzystanie z naszych bibliotek klienta, które obsługują tę funkcję.
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 założeniem konta w backendzie.
Jak obsługiwać Odczekaj pierwsze 5 minut, a potem ponawiaj próby co 30 sekund.
Wskazówki dotyczące profilaktyki Odczekaj kilka minut po utworzeniu konta, zanim wyślesz do niego prośby.
PodsumowanieToken dostępu w nagłówku żądania jest nieprawidłowy lub stracił ważność.
Typowe przyczyny Token dostępu został unieważniony.
Jak obsługiwać 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 tokeny dostępu i używaj ich ponownie, dopóki nie stracą ważności.
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 obsługiwać Pamiętaj, aby zalogować się na prawidłowe konto Google Ads (zwykle na konto menedżera) w celu obsługi protokołu OAuth. Możesz też zaprosić konto Google do korzystania z istniejącego konta Google Ads. Aby to zrobić, zaloguj się na konto menedżera, wybierz odpowiednie konto klienta lub menedżera, otwórz stronę 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 jest nieprawidłowy.
Jak obsługiwać Nie dotyczy
Wskazówki dotyczące profilaktyki Upewnij się, że przekazano prawidłowy token dostępu powiązany z kontem. Czasem jest mylony z tokenami odświeżania i kodami autoryzacji. Jeśli chcesz uzyskać dane logowania, które dają dostęp do wszystkich kont klientów w ramach konta menedżera, uzyskaj token odświeżania konta menedżera. Więcej informacji znajdziesz w przewodniku po tokenie dostępu i tokenie odświeżania oraz OAuth2.

AuthorizationError

CUSTOMER_NOT_ENABLED
PodsumowanieNie można uzyskać dostępu do konta klienta, ponieważ nie zostało ono włączone.
Typowe przyczyny Dzieje się tak, gdy konto klienta nie zakończyło się rejestracji lub zostało zdezaktywowane.
Jak obsługiwać Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został ukończony. Informacje na temat zdezaktywowanych kont znajdziesz w artykule Ponowna aktywacja zlikwidowanego konta Google Ads.
Wskazówki dotyczące profilaktyki Możesz z wyprzedzeniem sprawdzić, czy konto klienta jest dezaktywowane, sprawdzając stan ANULOWANO.
DEVELOPER_TOKEN_NOT_APPROVED
PodsumowanieToken programisty jest zatwierdzony do użycia tylko z kontami testowymi i próbuje uzyskać dostęp do konta innego niż testowe.
Typowe przyczyny Użyto testowego tokena programisty, aby uzyskać dostęp do konta innego niż testowe.
Jak obsługiwać Upewnij się, że faktycznie chcesz uzyskać dostęp do konta innego niż testowe. Jeśli tak, musisz poprosić o zmianę tokena programisty na dostęp standardowy lub podstawowy.
Wskazówki dotyczące profilaktyki Nie dotyczy
DEVELOPER_TOKEN_PROHIBITED
PodsumowanieW projekcie wysłanym w żądaniu nie można używać tokena programisty.
Typowe przyczyny Każdy projekt Konsoli interfejsów API Google można powiązać z tokenem programisty tylko z jednego konta menedżera. Po wysłaniu żądania do interfejsu Google Ads API token programisty zostaje trwale 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 wystąpi błąd DEVELOPER_TOKEN_PROHIBITED.
Jak obsługiwać 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
PodsumowanieUpoważniony klient nie ma dostępu do klienta operacyjnego.
Typowe przyczyny Uwierzytelnianie jako użytkownik z dostępem do konta menedżera bez określania adresu login-customer-id w żądaniu.
Jak obsługiwać Nie dotyczy
Wskazówki dotyczące profilaktyki Podaj login-customer-id jako identyfikator konta menedżera bez łączników (-). Biblioteki klienta udostępniają tę funkcję.