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

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 obejmuje zakresu OAuth 2.0 interfejsu Google Ads API. Jak postępować w przypadku Upewnij się, że token dostępu ma wymagane zakresy. Typową przyczyną tego błędu jest ponowne użycie istniejącego tokena dostępu wygenerowanego przy użyciu innego zestawu zakresów uprawnień OAuth. Przykładowy sposób 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 uprawnienia. Ponownie uwierzytelnij użytkownika z wymaganymi zakresami uprawnień, aby uzyskać dostęp z wymaganymi zakresami uprawnień. Jeśli Twoja aplikacja korzysta z kilku zakresów OAuth, konieczne może być 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 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, wykonując te instrukcje, 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	Podsumowanie Identyfikator 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	Podsumowanie Identyfikator 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	Podsumowanie Nie 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.
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ć 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	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 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	Podsumowanie Token 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 podrzędnych do konta menedżera, pamiętaj, aby uzyskać token odświeżania dla tego konta menedżera. Więcej informacji znajdziesz w przewodniku na temat tokenów dostępu i tokenów odświeżania oraz OAuth2.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	Podsumowanie Token dewelopera jest już powiązany z organizacją Google Cloud i nie można go powiązać z inną organizacją. Typowe przyczyny Token dewelopera nie jest powiązany z projektem Google Cloud w tej samej organizacji Google Cloud co projekt Google Cloud, z którego wysyłano pierwotne żądania. Jak postępować w przypadku Jeśli wysyłasz już żądania do interfejsu API za pomocą tokena programisty, upewnij się, że identyfikator klienta OAuth jest powiązany z projektami Google Cloud w tej samej organizacji Google Cloud. Wskazówki dotyczące profilaktyki Upewnij się, że wszystkie projekty Google Cloud są powiązane z tą samą organizacją Google Cloud. Projekt Google Cloud może być powiązany tylko z 1 tokenem dewelopera, ale token dewelopera może być powiązany z wieloma projektami w organizacji.
DEVELOPER_TOKEN_INVALID	Podsumowanie Token dewelopera jest nieprawidłowy. Typowe przyczyny Typowe przyczyny tego błędu to literówki w tokenie dewelopera lub nieprawidłowe ustawienie tokenu dewelopera w innym nagłówku żądania. Jak postępować w przypadku Aby uniknąć literówek, skopiuj token programisty z Centrum interfejsu API. Centrum interfejsu API znajdziesz na koncie menedżera Google Ads. Sprawdź też, czy token dewelopera jest ustawiany w poprawnym nagłówku. Tokeny dewelopera są czasami mylone z tokenami odświeżania OAuth i kodami autoryzacji. Więcej informacji o różnych nagłówkach żądań znajdziesz tutaj. Wskazówki dotyczące profilaktyki Nie dotyczy

AuthorizationError
CUSTOMER_NOT_ENABLED	Podsumowanie 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 jeszcze zarejestrowane lub zostało dezaktywowane. Jak postępować w przypadku Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został ukończony. Informacje o dezaktywowanych kontach znajdziesz w artykule Ponowna aktywacja zlikwidowanego konta Google Ads. Wskazówki dotyczące profilaktyki Możesz sprawdzić, czy konto klienta zostało zdezaktywowane, sprawdzając stan ZLIKWIDOWANE.
DEVELOPER_TOKEN_NOT_APPROVED	Podsumowanie Token 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 Dostęp do konta niebędącego kontem testowym uzyskano za pomocą testowego tokena dewelopera. Jak postępować w przypadku Upewnij się, że chcesz uzyskać dostęp do konta, które nie jest testowe. 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	Podsumowanie Token dewelopera jest niedozwolony w przypadku projektu przesłanego 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. 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	Podsumowanie Upoważ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.