Token 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 postępować
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
Podsumowanie
Token wygasł lub został unieważniony.
Typowe przyczyny
W przypadku projektu Google Cloud Platform ze skonfigurowanym ekranem zgody OAuth dla zewnętrznego typu użytkownika i stanem publikacji Testing wydawany jest token odświeżania, który wygasa po 7 dniach.
Jak postępować
Stan publikowania projektu Google to Testing, więc token odświeżania wygasa co 7 dni i wyświetla 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 uniknąć wygaśnięcia tokena odświeżania za 7 dni.
Próbujesz zmodyfikować atrybuty inne niż status reklamy.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Po utworzeniu reklamy nie można jej zmienić. Jeśli chcesz zmodyfikować reklamę, musisz utworzyć nową, a potem usunąć starą. status reklamy można jednak modyfikować za pomocą funkcji MutateAdGroupAds.
INVALID_INPUT
Podsumowanie
Jedno z pól w reklamie zawiera nieprawidłowe znaki.
Typowe przyczyny
Używanie znaków specjalnych w adresach URL.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Zanim wyślesz żądanie do interfejsu API, sprawdź adresy URL w aplikacji.
LINE_TOO_WIDE
Podsumowanie
Jedno z pól w reklamie było dłuższe niż maksymalna dozwolona długość. Zobacz Reklamy tekstowe.
Typowe przyczyny
zbyt długi wiersz tekstu;
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Przed wysłaniem żądania do interfejsu API sprawdź długość wiersza.
Numer 123-456-7890 powinien mieć format 1234567890. Więcej informacji znajdziesz w artykule Pierwsze kroki.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Podsumowanie
W nagłówku HTTP nie podano identyfikatora klienta.
Typowe przyczyny
Nie podajesz identyfikatora klienta w nagłówku HTTP.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Identyfikator klienta jest wymagany w przypadku wszystkich wywołań, więc upewnij się, że został on podany w nagłówku HTTP. Rozważ użycie naszych bibliotek klienta, ponieważ one zajmują się tym za Ciebie.
CUSTOMER_NOT_FOUND
Podsumowanie
Nie znaleziono konta dla identyfikatora klienta podanego w nagłówku.
Typowe przyczyny
Próba uzyskania dostępu do konta, które zostało właśnie utworzone, zanim zostanie ono skonfigurowane na serwerze backendu.
Jak postępować
Odczekaj 5 minut, a potem spróbuj ponownie co 30 sekund.
Wskazówki dotyczące profilaktyki
Po utworzeniu konta odczekaj kilka minut, zanim zaczniesz wysyłać do niego żądania.
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ć
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 wygasną.
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 jest włączona usługa Google Ads.
Jak postępować
W przypadku procesu OAuth zaloguj się na prawidłowe konto Google Ads (zwykle jest to konto menedżera). Możesz też zaprosić konto Google do uzyskania dostępu do obecnego konta Google Ads. Aby to zrobić, zaloguj się na konto menedżera, wybierz odpowiednie konto klienta lub konto menedżera, kliknij 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 był nieprawidłowy.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Sprawdź, czy przekazujesz 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, zdobądź token odświeżania dla tego konta. Zapoznaj się z przewodnikiem po uwierzytelnianiu użytkowników.
Projekt 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 dotyczącego konta Google Ads, które nie jest kontem testowym (produkcyjnym), użyto projektu Google Cloud z testowym poziomem dostępu. (W wersjach interfejsu API v24 i starszych ten warunek zwraca wartość AuthorizationError.ACTION_NOT_PERMITTED).
Nie można uzyskać dostępu do konta klienta, ponieważ nie jest ono w stanie włączonym.
Typowe przyczyny
Dzieje się tak, gdy rejestracja konta klienta nie została zakończona lub konto zostało wyłączone.
Jak postępować
Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został zakończony. W przypadku wyłączonych kont zapoznaj się z artykułem Ponowna aktywacja zlikwidowanego konta Google Ads.
Wskazówki dotyczące profilaktyki
Możesz aktywnie sprawdzać, czy konto klienta jest zdezaktywowane, wyszukując stan ZLIKWIDOWANE.
USER_PERMISSION_DENIED
Podsumowanie
Autoryzowany klient nie ma dostępu do klienta operacyjnego.
Typowe przyczyny
Uwierzytelnianie jako użytkownik z dostępem do konta menedżera, ale bez określania parametru login-customer-id w żądaniu.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Jako identyfikator konta menedżera podaj login-customer-id bez łączników (-). Biblioteki klienta mają wbudowaną obsługę tej funkcji.
Wartość stawki nie jest dokładną wielokrotnością minimalnej jednostki waluty konta. Na przykład 0, 015 PLN (15000 w mikrojednostkach) nie jest prawidłową stawką.
Typowe przyczyny
Nie dotyczy
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Sprawdź, czy stawki są wielokrotnością minimalnej jednostki waluty konta.
BID_TOO_BIG
Podsumowanie
Błąd jest zwracany, mimo że stawka mieści się w budżecie kampanii.
Kampania jest dodawana lub zmieniana, ale nazwa jest już używana przez inną kampanię.
Typowe przyczyny
Utworzenie nowej kampanii o nazwie istniejącej aktywnej lub wstrzymanej kampanii.
Jak postępować
Zapisz błąd w dzienniku i wyświetl użytkownikowi komunikat o błędzie. Możesz też zaproponować unikalną nazwę kampanii lub wyświetlić listę używanych nazw.
Wskazówki dotyczące profilaktyki
Nie dotyczy
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
Podsumowanie
Próba zmiany ustawienia typu dopasowania słów kluczowych na poziomie kampanii, w której włączono AI Max.
Typowe przyczyny
Gdy włączysz AI Max, ustawienia dopasowania przybliżonego na poziomie kampanii zostaną wycofane z użycia, ponieważ wszystkie słowa kluczowe będą domyślnie traktowane jako dopasowanie przybliżone. Próba ustawienia lub zmodyfikowania tego pola spowoduje błąd.
Jak postępować
Poinformuj użytkownika, aby zamiast ustawiać dopasowanie przybliżone na poziomie kampanii, używał parametru `disable_search_term_matching` na poziomie grupy reklam.
Wskazówki dotyczące profilaktyki
Unikaj ustawiania wartości „BROAD” (lub innej) w parametrze `keyword_match_type` w kampanii, jeśli parametr `ai_max_setting.enable_ai_max` ma wartość „true”. Przełącz dopasowywanie wyszukiwanych słów na poziomie grupy reklam za pomocą parametru `disable_search_term_matching`.
Upłynął limit czasu żądania i nie udało się go zrealizować wystarczająco szybko, aby zwrócić odpowiedź.
Typowe przyczyny
Wysłano żądanie wyszukiwania, które wygenerowało zbyt dużą odpowiedź, lub żądanie modyfikacji było zbyt duże, aby można je było przetworzyć.
Jak postępować
Zaczekaj około 30 sekund i spróbuj jeszcze raz. Jeśli błąd nadal występuje, spróbuj podzielić żądanie na kilka mniejszych, które można szybciej zrealizować.
Podczas przetwarzania żądania wystąpił nieoczekiwany błąd.
Typowe przyczyny
Interfejs API nie działa prawidłowo z powodu błędu.
Jak postępować
Ponów wszystkie żądania, które zakończyły się tym błędem, korzystając z harmonogramu ponawiania ze wzrastającym czasem do ponowienia.
Wskazówki dotyczące profilaktyki
Nie dotyczy
TRANSIENT_ERROR
Podsumowanie
Wystąpił przejściowy błąd wewnętrzny. Należy ponowić próbę.
Typowe przyczyny
Ten błąd występuje, gdy w interfejsie API wystąpi tymczasowy problem.
Jak postępować
Ponów wszystkie żądania, które zakończyły się tym błędem, korzystając z harmonogramu ponawiania ze wzrastającym czasem do ponowienia.
Wskazówki dotyczące profilaktyki
Nie dotyczy
InvalidGrantError
invalid_grant (malformed auth code)
Podsumowanie
Kod autoryzacji wymieniony na tokeny OAuth był nieprawidłowy.
Typowe przyczyny
Dzieje się tak podczas próby wygenerowania tokena odświeżania dla użytkownika, który ma już przyznany dostęp do aplikacji wysyłającej żądanie. Może się to zdarzyć na przykład wtedy, gdy przykład generowania danych logowania użytkownika zostanie uruchomiony więcej niż raz w przypadku tych samych danych logowania klienta OAuth i autoryzowanego użytkownika.
Jak postępować
Aby ponownie wygenerować token odświeżania dla danej kombinacji użytkownika autoryzującego i danych logowania klienta OAuth, unieważnij istniejący token odświeżania. Pamiętaj, że cofnięcie tokena uniemożliwia korzystanie z niego w celu uzyskania dostępu do interfejsu Google Ads API i unieważnia wszystkie tokeny dostępu wygenerowane za pomocą tokena odświeżania.
Wskazówki dotyczące profilaktyki
Aby uniknąć konieczności ponownego generowania tokena odświeżania, przechowuj go w bezpiecznym miejscu.
Żądanie odnosiło się do zasobu, którego nie można było znaleźć.
Typowe przyczyny
Żądanie próbowało zmienić lub w inny sposób odwołać się do zasobu, który nie istnieje lub został usunięty. lub podana nazwa zasobu jest nieprawidłowa.
Jak postępować
Przed przesłaniem żądania modyfikacji użyj żądania wyszukiwania, aby pobrać nazwę zasobu dla istniejącego zasobu. Zapoznaj się z naszymi przewodnikami po bibliotekach klienta, które zawierają dokumentację dotyczącą tworzenia prawidłowych nazw zasobów w każdym obsługiwanym języku.
Wskazówki dotyczące profilaktyki
Nie twórz nazw zasobów ręcznie. Użyj jednej z metod pomocniczych oferowanych przez nasze biblioteki klienta.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2026-09-29 UTC."],[],[]]
