Typowe błędy

W tym przewodniku znajdziesz listę typowych błędów interfejsu API oraz strategie ich zapobiegania i obsługi.

Pełną listę wszystkich typów błędów znajdziesz w dokumentacji błędów interfejsu Google Ads API reference. Jeśli potrzebujesz dodatkowej pomocy, zadaj pytanie na forum interfejsu Google Ads API.

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
PodsumowanieToken dostępu OAuth 2.0 nie ma wymaganych zakresów.
Typowe przyczyny Żądanie zostało odrzucone, ponieważ podany token dostępu nie zawiera zakresu OAuth 2.0 interfejsu Google Ads API.
Jak sobie poradzić Sprawdź, czy token dostępu ma wymagane zakresy. Częstą przyczyną tego błędu jest ponowne użycie istniejącego tokena dostępu, który został wygenerowany przy użyciu innego zestawu zakresów OAuth. Przykład generowania nowego tokena dostępu z wymaganymi zakresami znajdziesz w sekcji Parametry autoryzacji OAuth.
Wskazówki dotyczące profilaktyki Sprawdź, czy token dostępu ma wymagane zakresy. Ponownie uwierzytelnij użytkownika z wymaganymi zakresami, aby uzyskać dostęp z wymaganymi zakresami. Jeśli Twoja aplikacja używa wielu zakresów OAuth, może być konieczne wdrożenie szczegółowych uprawnień OAuth.

google.auth.exceptions.RefreshError
invalid_grant
PodsumowanieToken wygasł lub został unieważniony.
Typowe przyczyny Projekt Google Cloud Platform z ekranem zgody OAuth skonfigurowanym dla typu użytkownika zewnętrznego i stanem publikacji Testing otrzymuje token odświeżania, który wygasa po 7 dniach.
Jak sobie poradzić Stan publikacji Twojego projektu Google to Testing, więc token odświeżania wygasa co 7 dni i otrzymujesz 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, aby token odświeżania nie wygasał po 7 dniach.
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 sobie poradzić 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ł określony w nagłówku HTTP.
Typowe przyczyny Nieokreślenie identyfikatora klienta w nagłówku HTTP.
Jak sobie poradzić Nie dotyczy
Wskazówki dotyczące profilaktyki Identyfikator klienta jest wymagany w przypadku wszystkich wywołań, dlatego upewnij się, że został on określony w nagłówku HTTP. Rozważ użycie naszych bibliotek klienta, ponieważ obsługują one tę kwestię.
CUSTOMER_NOT_FOUND
PodsumowanieNie znaleziono konta dla identyfikatora klienta podanego w nagłówku.
Typowe przyczyny Próba uzyskania dostępu do konta, które zostało utworzone tuż przed jego utworzeniem w backendzie.
Jak sobie poradzić Odczekaj 5 minut, a potem powtarzaj próbę co 30 sekund.
Wskazówki dotyczące profilaktyki Zanim wyślesz żądania do konta, odczekaj kilka minut po jego utworzeniu.
PodsumowanieToken dostępu w nagłówku żądania jest nieprawidłowy lub wygasł.
Typowe przyczyny Token dostępu został unieważniony.
Jak sobie poradzić 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 i ponownie używaj 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 dane logowania odpowiadają kontu Google, na którym nie jest włączona usługa Google Ads.
Jak sobie poradzić W przypadku procesu OAuth zaloguj się na prawidłowe konto Google Ads (zwykle konto menedżera). Możesz też zaprosić konto Google do uzyskania dostępu do istniejącego konta Google Ads. W tym celu zaloguj się na konto menedżera, wybierz odpowiednie konto klienta lub menedżera, otwórz 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 był nieprawidłowy.
Jak sobie poradzić Nie dotyczy
Wskazówki dotyczące profilaktyki Upewnij się, że przekazujesz prawidłowy token dostępu powiązany z Twoim kontem. Czasami jest on mylony z tokenami odświeżania i kodami autoryzacji. Jeśli chcesz uzyskać dane logowania, które mogą uzyskać dostęp do wszystkich kont klienta na koncie menedżera, upewnij się, że masz token odświeżania dla konta menedżera. Zapoznaj się z przewodnikiem po uwierzytelnianiu użytkowników.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
PodsumowanieProjekt Google Cloud ma tylko dostęp testowy i nie można go używać do uzyskiwania dostępu do kont produkcyjnych.
Typowe przyczyny Do wysłania żądania do konta Google Ads innego niż testowe (produkcyjne) użyto projektu Google Cloud z poziomem dostępu Test. (W wersjach interfejsu API 24 i starszych ten warunek zwraca AuthorizationError.ACTION_NOT_PERMITTED.)
Jak sobie poradzić Jeśli testujesz, upewnij się, że żądanie jest kierowane na konto testowe. Jeśli chcesz uzyskać dostęp do produkcyjnego konta Google Ads, sprawdź poziom dostępu projektu w chmurze Google Cloud na stronie Przegląd interfejsu Google Ads API i uaktualnij poziom dostępu projektu do poziomu eksploratora, Basic lub dostępu standardowego.
Wskazówki dotyczące profilaktyki Nie dotyczy
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 zarejestrowane lub zostało dezaktywowane.
Jak sobie poradzić Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został zakończony. W przypadku kont dezaktywowanych zapoznaj się z artykułem Ponowne aktywowanie zlikwidowanego konta Google Ads.
Wskazówki dotyczące profilaktyki Możesz proaktywnie sprawdzić, czy konto klienta jest dezaktywowane, sprawdzając stan ANULOWANE.
USER_PERMISSION_DENIED
PodsumowanieUwierzytelniony klient nie ma dostępu do klienta operacyjnego.
Typowe przyczyny Uwierzytelnianie jako użytkownik z dostępem do konta menedżera, ale bez określenia login-customer-id w żądaniu.
Jak sobie poradzić Nie dotyczy
Wskazówki dotyczące profilaktyki Określ login-customer-id jako identyfikator konta menedżera bez łączników (-). Biblioteki klienta mają wbudowaną obsługę tej funkcji.

Wstecz
Obsługa błędów
Dalej
Dalsze kroki