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 zapobiegania im i radzenia sobie z nimi.
Pełną listę błędów znajdziesz w dokumentacji błędów. Dodatkową pomoc uzyskasz na naszym 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 z tym radzić |
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 korzysta z 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 ze skonfigurowanym ekranem zgody OAuth dla zewnętrznego typu użytkownika i stanem publikacji Testing otrzymuje token odświeżania, który wygasa za 7 dni.
|
|---|
| Jak sobie z tym radzić |
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 publikowania na In production, postępując zgodnie z tymi instrukcjami, aby uniknąć wygaśnięcia tokena odświeżania w ciągu 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 sobie z tym radzić |
Nie dotyczy
|
|---|
| Wskazówki dotyczące profilaktyki |
123-456-7890 powinno być 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 podanie identyfikatora klienta w nagłówku HTTP.
|
|---|
| Jak sobie z tym radzić |
Nie dotyczy
|
|---|
| Wskazówki dotyczące profilaktyki |
Identyfikator klienta jest wymagany w przypadku wszystkich wywołań, więc upewnij się, że został on określony w nagłówku HTTP. Rozważ użycie naszych bibliotek klienta, ponieważ one zajmują się tym 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 dopiero niedawno, zanim zostało ono utworzone w systemie backendu.
|
|---|
| Jak sobie z tym radzić |
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 sobie z tym radzić |
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 wykorzystuj tokeny 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 z tym radzić |
W przypadku procesu OAuth zaloguj się na prawidłowe konto Google Ads (zwykle konto menedżera). Możesz też zaprosić konto Google do korzystania z 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 potem 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 sobie z tym radzić |
Nie dotyczy
|
|---|
| Wskazówki dotyczące profilaktyki |
Sprawdź, czy przekazujesz prawidłowy token dostępu powiązany z Twoim kontem. Jest on czasami 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, uzyskaj token odświeżania dla konta menedżera. Więcej informacji znajdziesz w naszym przewodniku po tokenach dostępu i tokenach 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 programisty nie jest powiązany z projektem Google Cloud w tej samej organizacji Google Cloud co projekt Google Cloud użyty do pierwotnego wysłania żądań.
|
|---|
| Jak sobie z tym radzić |
Jeśli masz już za sobą wywołania 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.
|
|---|
|
DEVELOPER_TOKEN_INVALID |
| Podsumowanie | Token programisty jest nieprawidłowy. |
|---|
| Typowe przyczyny |
Typowe przyczyny tego błędu to literówki w tokenie dewelopera lub nieprawidłowe ustawienie tokena dewelopera w innym nagłówku żądania.
|
|---|
| Jak sobie z tym radzić |
Aby uniknąć błędów, skopiuj token programisty z centrum interfejsu API. Centrum interfejsu API znajdziesz na koncie menedżera Google Ads. Upewnij się też, że token dewelopera jest ustawiony w prawidłowym nagłówku. Tokeny dewelopera są czasami mylone z tokenami odświeżania OAuth i kodami autoryzacji. Więcej informacji o różnych nagłówkach żądań znajdziesz tutaj.
|
|---|
| 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łączone. |
|---|
| Typowe przyczyny |
Dzieje się tak, gdy konto klienta nie zostało zarejestrowane lub zostało wyłączone.
|
|---|
| Jak sobie z tym radzić |
Zaloguj się w interfejsie Google Ads i upewnij się, że proces rejestracji tego konta został zakończony. W przypadku dezaktywowanych 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 CANCELLED.
|
|---|
|
DEVELOPER_TOKEN_NOT_APPROVED |
| Podsumowanie | Token dewelopera jest zatwierdzony tylko do użytku na kontach testowych, a użytkownik próbował uzyskać dostęp do konta innego niż testowe. |
|---|
| Typowe przyczyny |
Do uzyskania dostępu do konta testowego użyto testowego tokena dewelopera.
|
|---|
| Jak sobie z tym radzić |
Upewnij się, że chcesz uzyskać dostęp do konta, które nie jest kontem testowym. W takim przypadku musisz złożyć wniosek o zwiększenie poziomu dostępu tokena dewelopera do poziomu Standard lub Podstawowy.
|
|---|
| Wskazówki dotyczące profilaktyki |
Nie dotyczy
|
|---|
|
DEVELOPER_TOKEN_PROHIBITED |
| Podsumowanie | 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. Po wysłaniu żądania 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 otrzymasz błąd DEVELOPER_TOKEN_PROHIBITED.
|
|---|
| Jak sobie z tym radzić |
Nie dotyczy
|
|---|
| Wskazówki dotyczące profilaktyki |
Jeśli przechodzisz na token programisty na nowym koncie menedżera, musisz utworzyć nowy projekt w Konsoli interfejsów API Google na potrzeby żądań interfejsu Google Ads API, które używają tokena nowego menedżera.
|
|---|
|
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ślenia login-customer-id w żądaniu.
|
|---|
| Jak sobie z tym radzić |
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.
|
|---|
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-31 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-31 UTC."],[[["\u003cp\u003eThis page provides solutions and preventative measures for common Google Ads API errors.\u003c/p\u003e\n"],["\u003cp\u003eFor a comprehensive list of errors, refer to the dedicated error references section.\u003c/p\u003e\n"],["\u003cp\u003eAdditional assistance and community support can be found on the Google Ads API forum.\u003c/p\u003e\n"],["\u003cp\u003eUnderstanding and addressing these errors is crucial for successful API integration and campaign management.\u003c/p\u003e\n"]]],[],null,[]]
