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 protokołu 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
Upewnij się, że 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
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 postępować
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 publikowania na In production, aby token odświeżania nie wygasł po 7 dniach.
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 podano identyfikatora klienta w nagłówku HTTP.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Identyfikator klienta jest wymagany we wszystkich wywołaniach, więc upewnij się, że został podany w nagłówku HTTP. Rozważ użycie naszych bibliotek klienta, które zajmą się tym za Ciebie.
CUSTOMER_NOT_FOUND
Podsumowanie
Nie znaleziono konta o identyfikatorze klienta podanym w nagłówku.
Typowe przyczyny
Próba uzyskania dostępu do konta, które zostało właśnie utworzone, zanim zostanie ono skonfigurowane w systemie backendowym.
Jak postępować
Odczekaj 5 minut, a następnie ponawiaj próbę 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 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 postępować
Pamiętaj, aby zalogować się na prawidłowe konto Google Ads (zwykle konto menedżera) w przepływie OAuth. Możesz też zaprosić konto Google do dostępu do istniejącego konta Google Ads, logując się na konto menedżera, wybierając odpowiednie konto klienta lub menedżera, przechodząc do Tools and Settings > Access and security, a następnie dodając 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 z nagłówkiem HTTP był nieprawidłowy.
Jak postępować
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 umożliwiają 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 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
Projekt Google Cloud z poziomem dostępu Test został użyty do wysłania żądania do konta Google Ads innego niż testowe (produkcyjnego). (W interfejsie API w wersji 24 i starszych ten warunek zwraca wartość AuthorizationError.ACTION_NOT_PERMITTED).
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 zarejestrowane lub zostało dezaktywowane.
Jak postępować
Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został zakończony. W przypadku kont wyłączonych zapoznaj się z artykułem Ponowna aktywacja zlikwidowanego konta Google Ads.
Wskazówki dotyczące profilaktyki
Możesz proaktywnie sprawdzić, czy konto klienta jest zdezaktywowane, sprawdzając, czy ma stan CANCELLED.
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 podawania w żądaniu parametru login-customer-id;
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Podaj login-customer-id jako identyfikator konta menedżera bez łączników (-). Biblioteki klienta mają wbudowaną obsługę tej funkcji.
[[["Ł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-11-13 UTC."],[],[]]