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
W przypadku projektu Google Cloud Platform z ekranem zgody OAuth skonfigurowanym dla typu użytkownika zewnętrznego i stanem publikacji Testing token odświeżania 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.
Po utworzeniu reklamy nie można jej zmienić. Jeśli chcesz zmodyfikować reklamę, musisz utworzyć nową, a potem usunąć starą. status reklamy można jednak zmienić za pomocą metody MutateAdGroupAds.
INVALID_INPUT
Podsumowanie
Jedno z pól w reklamie zawiera nieprawidłowe znaki.
Typowe przyczyny
używanie znaków specjalnych w adresach URL;
Jak postępować
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 pól w reklamie przekroczyło maksymalną dozwoloną długość. Więcej informacji o reklamach tekstowych
Typowe przyczyny
Zbyt długa linijka tekstu.
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Przed wysłaniem żądania do interfejsu API sprawdź długość wiersza.
Dodajesz grupę reklam lub zmieniasz jej nazwę, ale nazwa jest już używana przez inną grupę reklam.
Typowe przyczyny
utworzenie nowej grupy reklam o nazwie istniejącej aktywnej lub wstrzymanej grupy reklam;
Jak postępować
Zarejestruj błąd i wyświetl użytkownikowi komunikat o błędzie, opcjonalnie sugerując unikalną nazwę grupy reklam lub wyświetlając listę używanych nazw.
Dwie operacje w jednym żądaniu zawierają operację utworzenia komponentu z tymi samymi danymi binarnymi.
Typowe przyczyny
Żądanie modyfikacji ze zduplikowanymi operacjami tworzenia zawierającymi te same dane binarne.
Jak postępować
Utwórz komponent w osobnym żądaniu, a potem utwórz do niego link w kolejnym żądaniu. Możesz też użyć tymczasowego identyfikatora w tym samym żądaniu.
Wskazówki dotyczące profilaktyki
Nie dotyczy
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE
Podsumowanie
Identyfikator promocji partnera używa wariantu oneof (int_value lub string_value), którego nie akceptuje integracja promocji na koncie.
Typowe przyczyny
Ustawienie pola promotion_asset.external_redeem_info.partner_promotion_id.int_value, gdy integracja wykorzystania przez klienta wymaga wariantu string_value, lub ustawienie pola string_value, gdy integracja wymaga wariantu int_value.
Zanim utworzysz wiadomość PromotionAsset z polem external_redeem_info, sprawdź, którego formatu identyfikatora promocji (int_value lub string_value) używa Twoja integracja z punktem sprzedaży (POS).
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 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
Do wysłania żądania do konta Google Ads innego niż testowe (produkcyjnego) użyto projektu Google Cloud z poziomem dostępu Test. (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 wyłączone.
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, na którego koncie wykonywane są operacje.
Typowe przyczyny
uwierzytelnianie jako użytkownik z dostępem do konta menedżera, ale bez podawania login-customer-id w żądaniu;
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.
Wartość stawki nie jest dokładną wielokrotnością minimalnej jednostki waluty konta. Na przykład 0, 015 USD (15000 w mikrowalucie) nie jest prawidłową stawką.
Typowe przyczyny
Nie dotyczy
Jak postępować
Nie dotyczy
Wskazówki dotyczące profilaktyki
Sprawdź, czy stawki są wielokrotnością minimalnej jednostki waluty konta.
BID_TOO_BIG
Podsumowanie
Błąd jest zwracany, mimo że stawka mieści się w budżecie kampanii.
Dodajesz kampanię lub zmieniasz jej nazwę, ale ta nazwa jest już używana przez inną kampanię.
Typowe przyczyny
utworzysz nową kampanię o nazwie istniejącej aktywnej lub wstrzymanej kampanii;
Jak postępować
Zarejestruj błąd i wyświetl użytkownikowi komunikat o błędzie, opcjonalnie sugerując unikalną nazwę kampanii lub wyświetlając listę używanych nazw.
Wskazówki dotyczące profilaktyki
Nie dotyczy
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
Podsumowanie
Próba zmiany ustawienia typu dopasowania słów kluczowych na poziomie kampanii w kampanii z włączonymi funkcjami AI Max.
Typowe przyczyny
Po włączeniu funkcji AI Max ustawienia dopasowania przybliżonego na poziomie kampanii są wycofywane, ponieważ wszystkie słowa kluczowe są domyślnie traktowane jako słowa kluczowe w dopasowaniu przybliżonym. Próba ustawienia lub zmodyfikowania tego pola spowoduje błąd.
Jak postępować
Zalecamy użytkownikowi użycie parametru `disable_search_term_matching` na poziomie grupy reklam zamiast ustawiania dopasowania przybliżonego na poziomie kampanii.
Wskazówki dotyczące profilaktyki
Jeśli parametr `ai_max_setting.enable_ai_max` ma wartość `true`, nie ustawiaj w kampanii parametru `keyword_match_type` na wartość `BROAD` (ani na żadną inną wartość). Dopasowywanie wyszukiwanych słów możesz włączać i wyłączać na poziomie grupy reklam za pomocą parametru `disable_search_term_matching`.
Przeniesionej kampanii generującej popyt nie można aktywować, dopóki nie zostanie usunięta pierwotna kampania lub gdy inna przeniesiona kampania utworzona na podstawie tej samej pierwotnej kampanii jest już aktywna.
Typowe przyczyny
Aktualizowanie stanu status przeniesionej kampanii generującej popyt na ENABLED, gdy pierwotna kampania źródłowa nie została usunięta lub inna kampania generująca popyt przeniesiona z tej samej pierwotnej kampanii ma już stan ENABLED. W interfejsie API w wersji 25 i starszych ten warunek zwraca wartość RequestError.UNKNOWN.
Jak postępować
Zanim aktywujesz przeniesioną kampanię generującą popyt, usuń pierwotną kampanię źródłową za pomocą metody CampaignOperation.remove (wcześniej lub w tym samym żądaniu modyfikacji) i sprawdź, czy nie jest aktywna żadna inna kampania generująca popyt przeniesiona z tej samej pierwotnej kampanii. Więcej informacji znajdziesz w sekcji Aktywowanie przeniesionych kampanii.
Wskazówki dotyczące profilaktyki
Jeśli śledzisz identyfikatory pierwotnych kampanii źródłowych i przeniesionych kampanii generujących popyt, przed ustawieniem w przeniesionej kampanii pola status na wartość ENABLED wyślij zapytanie do campaign.status lub w tym samym żądaniu modyfikacji uwzględnij dla pierwotnej kampanii pole CampaignOperation.remove.
Upłynął limit czasu żądania i nie udało się go zrealizować wystarczająco szybko, aby zwrócić odpowiedź.
Typowe przyczyny
Zostało wysłane żądanie wyszukiwania, które wygenerowało zbyt dużą odpowiedź, lub żądanie modyfikacji było zbyt duże, aby można było je przetworzyć.
Jak postępować
Zaczekaj około 30 sekund i spróbuj jeszcze raz. Jeśli błąd będzie się powtarzał, spróbuj podzielić żądanie na kilka mniejszych, które można szybciej zrealizować.
Podczas przetwarzania żądania wystąpił nieoczekiwany błąd.
Typowe przyczyny
Interfejs API nie działa prawidłowo z powodu błędu.
Jak postępować
Ponów wszystkie żądania, które nie powiodły się z powodu tego błędu, stosując harmonogram ponownych prób ze wzrastającym czasem do ponowienia.
Wskazówki dotyczące profilaktyki
Nie dotyczy
TRANSIENT_ERROR
Podsumowanie
Wystąpił przejściowy błąd wewnętrzny i należy ponowić próbę.
Typowe przyczyny
Ten błąd występuje, gdy interfejs API napotka tymczasowy problem wewnętrzny.
Jak postępować
Ponów wszystkie żądania, które nie powiodły się z powodu tego błędu, stosując harmonogram ponownych prób ze wzrastającym czasem do ponowienia.
Wskazówki dotyczące profilaktyki
Nie dotyczy
InvalidGrantError
invalid_grant (malformed auth code)
Podsumowanie
Kod autoryzacji wymieniony na tokeny OAuth był 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 wysyłającej żądanie. Może się tak zdarzyć na przykład wtedy, gdy uruchomisz przykład generowania danych logowania użytkownika więcej niż raz dla tych samych danych logowania klienta OAuth i autoryzującego użytkownika.
Jak postępować
Aby ponownie wygenerować token odświeżania dla danej kombinacji autoryzującego użytkownika i danych logowania klienta OAuth, unieważnij istniejący token odświeżania. Pamiętaj, że unieważnienie tokena uniemożliwia korzystanie z niego do uzyskiwania dostępu do interfejsu Google Ads API i powoduje unieważnienie wszystkich tokenów dostępu, które zostały wygenerowane za pomocą tokena odświeżania.
Wskazówki dotyczące profilaktyki
Pamiętaj, aby przechowywać token odświeżania w bezpiecznym miejscu, aby uniknąć konieczności jego ponownego generowania.
Żądanie odnosiło się do zasobu, którego nie udało się znaleźć.
Typowe przyczyny
Żądanie próbowało zmienić lub w inny sposób odwołać się do zasobu, który nie istnieje lub został usunięty. Możliwe też, że podana nazwa zasobu jest nieprawidłowa.
Jak postępować
Przed przesłaniem żądania modyfikacji użyj żądania wyszukiwania, aby pobrać nazwę istniejącego zasobu. Zapoznaj się z przewodnikami po bibliotekach klienta, które zawierają dokumentację dotyczącą 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.
Żądanie próbuje utworzyć zasób, który spowodowałby przekroczenie określonego limitu łącznej liczby tych zasobów.
Typowe przyczyny
Istnieje kilka limitów liczby zasobów, które mogą istnieć w określonych kontekstach.
Jak postępować
Sprawdź limity systemowe, aby dowiedzieć się, który limit został osiągnięty. Użyj ponownie istniejącego zasobu lub usuń zasoby, aby zrobić miejsce na nowe.
Wskazówki dotyczące profilaktyki
Używaj zapytań, aby sprawdzać liczbę zasobów, które mają ograniczenia.
[[["Ł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-10-30 UTC."],[],[]]