Najczęstsze błędy
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 ich zapobiegania i rozwiązywania.
Pełną listę błędów znajdziesz w dokumentacji 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 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, być może trzeba będzie wdrożyć szczegółowe uprawnienia 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 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 pojawia się 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.
123-456-7890 powinno być 1234567890. Więcej informacji znajdziesz w przewodniku dla początkujących.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Podsumowanie
W nagłówku HTTP nie podano identyfikatora klienta.
Typowe przyczyny
Niepodanie 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ń, więc upewnij się, że został 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 utworzone tuż przed jego utworzeniem w backendzie.
Jak sobie poradzić
Odczekaj 5 minut, a potem ponawiaj próbę co 30 sekund.
Wskazówki dotyczące profilaktyki
Zanim zaczniesz wysyłać żądania do konta, odczekaj kilka minut po jego utworzeniu.
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 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
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 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. Aby to zrobić, 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
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 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 klientów na koncie menedżera, upewnij się, że masz token odświeżania dla konta menedżera. Zapoznaj się z przewodnikiem uwierzytelniania użytkownika.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
Podsumowanie
Token programisty jest już powiązany z organizacją Google Cloud i nie można go powiązać z inną organizacją.
Typowe przyczyny
Token programisty nie jest powiązany z projektem w chmurze Google Cloud w tej samej organizacji Google Cloud co projekt w chmurze Google Cloud, który był pierwotnie używany do wysyłania żądań.
Jak sobie poradzić
Jeśli masz już żądania interfejsu API z tokenem 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 Twoje projekty Google Cloud są powiązane z tą samą organizacją Google Cloud. Projekt Google Cloud można powiązać tylko z 1 tokenem programisty, ale token programisty można powiązać z wieloma projektami w organizacji.
DEVELOPER_TOKEN_INVALID
Podsumowanie
Token programisty jest nieprawidłowy.
Typowe przyczyny
Typowe przyczyny tego błędu to literówki w tokenie programisty lub nieprawidłowe ustawienie tokena programisty w innym nagłówku żądania.
Jak sobie poradzić
Aby uniknąć literówek, skopiuj token programisty z Centrum API. Centrum API znajdziesz na koncie menedżera Google Ads. Upewnij się też, że ustawiasz token programisty w prawidłowym nagłówku. Tokeny programisty są czasami mylone z tokenami odświeżania OAuth i kodami autoryzacji. Więcej informacji o różnych nagłówkach żądań znajdziesz tutaj.
Nie można uzyskać dostępu do konta klienta, ponieważ nie jest ono włączone.
Typowe przyczyny
Dzieje się tak, gdy rejestracja konta klienta nie została ukończona lub konto zostało wyłączone.
Jak sobie poradzić
Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został ukończony. W przypadku wyłączonych kont zapoznaj się z artykułem Ponowne aktywowanie zlikwidowanego konta Google Ads.
Wskazówki dotyczące profilaktyki
Możesz proaktywnie sprawdzić, czy konto klienta jest wyłączone, sprawdzając stan ANULOWANE.
DEVELOPER_TOKEN_NOT_APPROVED
Podsumowanie
Token programisty jest zatwierdzony tylko do użytku z kontami testowymi i próbowano uzyskać dostęp do konta innego niż testowe.
Typowe przyczyny
Do uzyskania dostępu do konta innego niż testowe użyto testowego tokena programisty.
Jak sobie poradzić
Upewnij się, że rzeczywiście chcesz uzyskać dostęp do konta innego niż testowe. Jeśli tak, musisz złożyć wniosek o uaktualnienie tokenu programisty do standardowego lub podstawowego poziomu dostępu.
Wskazówki dotyczące profilaktyki
Nie dotyczy
DEVELOPER_TOKEN_PROHIBITED
Podsumowanie
Token programisty jest niedozwolony w przypadku projektu wysłanego w żądaniu.
Typowe przyczyny
Każdy projekt w konsoli interfejsów API Google może być powiązany z tokenem programisty tylko 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żyjesz nowego projektu w konsoli interfejsów API Google, podczas wysyłania żądania pojawi się błąd DEVELOPER_TOKEN_PROHIBITED.
[[["Ł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-07-29 UTC."],[],[]]
