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ć dalszą pomoc, odwiedź nasze forum.

google.auth.exceptions.RefreshError

invalid_grant
PodsumowanieToken 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, postępując zgodnie z tymi instrukcjami, aby uniknąć wygaśnięcia tokenu odświeżania po 7 dniach.
Wskazówki dotyczące profilaktyki Zapoznaj się z artykułem Niezweryfikowane aplikacje.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
PodsumowanieIdentyfikator 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
PodsumowanieIdentyfikator 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
PodsumowanieNie 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.
PodsumowanieToken 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
PodsumowanieKonto 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
PodsumowanieToken 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 na koncie menedżera, pamiętaj, aby uzyskać token odświeżania dla tego konta. Więcej informacji znajdziesz w artykule o tokenach dostępu i tokenach odświeżania oraz w artykule o 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 jeszcze zarejestrowane lub zostało dezaktywowane.
Jak postępować w przypadku Zaloguj się w interfejsie Google Ads i sprawdź, czy proces rejestracji na tym koncie został już ukończony. Informacje o dezaktywowanych kont znajdziesz w artykule Ponowna aktywacja zlikwidowanego konta Google Ads.
Wskazówki dotyczące profilaktyki Możesz sprawdzić, czy konto klienta zostało wyłączone, sprawdzając stan ZLIKWIDOWANE.
DEVELOPER_TOKEN_NOT_APPROVED
PodsumowanieToken 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 Do uzyskania dostępu do konta, które nie jest kontem testowym, użyto testowego tokena dewelopera.
Jak postępować w przypadku Upewnij się, że chcesz uzyskać dostęp do konta, które nie jest kontem testowym. 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
PodsumowanieToken dewelopera jest niedozwolony w projekcie przesłanym w żądaniu.
Typowe przyczyny Każdy projekt w Konsoli interfejsów API Google może być powiązany tylko z tokenem programisty z 1 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
PodsumowanieUpoważ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.