Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Typowe błędy

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

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

`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 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.

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.
Wskazówki dotyczące profilaktyki	Zobacz Niezweryfikowane aplikacje.

CLIENT_CUSTOMER_ID_INVALID

Podsumowanie	Identyfikator klienta nie jest liczbą.
Typowe przyczyny	Używanie nieprawidłowego identyfikatora klienta.
Jak postępować	Nie dotyczy
Wskazówki dotyczące profilaktyki	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.

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION

Podsumowanie	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`).
Jak postępować	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 do projektu Google Cloud na stronie Przegląd interfejsu Google Ads API i zwiększ poziom dostępu do projektu do poziomu Eksplorator, Podstawowy lub Standardowy.
Wskazówki dotyczące profilaktyki	Nie dotyczy

CUSTOMER_NOT_ENABLED

Podsumowanie	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.