Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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ć
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.
Operatora nie można używać w przypadku podklasy reklamy.
Typowe przyczyny
próbujesz zmodyfikować atrybuty inne niż status reklamy.
Jak postępować w przypadku
Nie dotyczy
Wskazówki dotyczące profilaktyki
Po utworzeniu reklamy nie można jej modyfikować. Jeśli chcesz zmodyfikować reklamę, musisz utworzyć nową, a potem usunąć starą. status reklamy można jednak zmodyfikować za pomocą wywołania MutateAdGroupAds.
INVALID_INPUT
Podsumowanie
Jedno z polów w reklamie zawiera nieprawidłowe znaki.
Typowe przyczyny
Używanie znaków specjalnych w adresach URL.
Jak postępować w przypadku
Nie dotyczy
Wskazówki dotyczące profilaktyki
Przed wysłaniem żądania do interfejsu API sprawdź adresy URL w aplikacji.
LINE_TOO_WIDE
Podsumowanie
Jedno z pol w reklamie było dłuższe niż maksymalna dozwolona długość. Zobacz Reklamy tekstowe.
Typowe przyczyny
Za długi wiersz tekstu.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Przed wysłaniem żądania do interfejsu API sprawdź długość linii.
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ć
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ć
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ć
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ć
Pamiętaj, aby zalogować się na prawidłowe konto Google Ads (zwykle na 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ć
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ć
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.
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 nietestowego uzyskano za pomocą testowego tokena dewelopera.
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.
Upłynął limit czasu żądania i nie udało się go zrealizować na tyle szybko, aby zdążyć z odpowiedzią.
Typowe przyczyny
przesłano żądanie wyszukiwania, które wygenerowało zbyt dużą odpowiedź lub żądanie modyfikacji było zbyt duże do przetworzenia;
Jak postępować w przypadku
Zaczekaj około 30 sekund i spróbuj jeszcze raz. Jeśli błąd się powtarza, spróbuj podzielić żądanie na kilka mniejszych żądań, które można wykonać szybciej.
Podczas przetwarzania żądania wystąpił nieoczekiwany błąd.
Typowe przyczyny
Interfejs API nie działa prawidłowo z powodu błędu.
Jak postępować
Ponownie wysyłaj żądania, które zakończyły się niepowodzeniem z tym błędem, używając do ponownych prób algorytmu wzrastającego czasu do ponowienia.
Wskazówki dotyczące profilaktyki
Nie dotyczy
TRANSIENT_ERROR
Podsumowanie
Wystąpił przejściowy błąd wewnętrzny. Należy spróbować ponownie.
Typowe przyczyny
Ten błąd występuje, gdy interfejs API napotka tymczasowy problem wewnętrzny.
Jak postępować
Ponownie wysyłaj żądania, które zakończyły się niepowodzeniem z tym błędem, używając do ponownych prób algorytmu wzrastającego czasu do ponowienia.
Wskazówki dotyczące profilaktyki
Nie dotyczy
InvalidGrantError
invalid_grant (malformed auth code)
Podsumowanie
Kod autoryzacji wymieniony na tokeny OAuth jest nieprawidłowy.
Typowe przyczyny
Dzieje się tak, gdy próbujesz wygenerować token odświeżania dla użytkownika, który ma już dostęp do aplikacji przesyłającej żądanie. Może się tak zdarzyć, gdy przykład generowania danych uwierzytelniających użytkownika zostanie uruchomiony więcej niż raz z tymi samymi danymi uwierzytelniania klienta OAuth i tym samym autoryzowanym użytkownikiem.
Jak postępować
Aby wygenerować token odświeżania dla danej kombinacji danych logowania użytkownika upoważniającego i klienta OAuth, unieważnij istniejący token odświeżania. Pamiętaj, że cofnięcie tokenu powoduje, że nie można go używać do uzyskiwania dostępu do interfejsu Google Ads API, a także unieważnia wszystkie tokeny dostępu, które zostały wygenerowane przy użyciu tokena odświeżania.
Wskazówki dotyczące profilaktyki
Aby uniknąć konieczności odtwarzania, przechowuj token odświeżania w bezpiecznym miejscu.
Żądanie odnosiło się do zasobu, którego nie udało się znaleźć.
Typowe przyczyny
W żądaniu nastąpiła próba zmodyfikowania zasobu, który nie istnieje lub został usunięty, lub odwołania się do niego. Może też być tak, że podana nazwa zasobu jest zniekształcona.
Jak postępować
Zanim prześlesz żądanie zmodyfikowania zasobu, użyj zapytania wyszukiwania, aby pobrać nazwę istniejącego zasobu. Zapoznaj się z przewodnikiem biblioteki klienta, który zawiera dokumentację na temat tworzenia prawidłowych nazw zasobów we wszystkich obsługiwanych językach.
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: 2025-06-04 UTC."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]