Najczęstsze błędy
Na tej stronie znajdziesz listę typowych błędów oraz wskazówki dotyczące zapobiegania im i rozwiązywania problemów z nimi związanych.
Pełną listę błędów znajdziesz w dokumentacji dotyczącej błędów. Aby uzyskać dalszą pomoc, odwiedź nasze forum.
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 zewnętrznego typu użytkownika i ze stanem publikowania Testing otrzymuje token odświeżania, który wygasa za 7 dni.
|
Jak postępować w przypadku |
Stan publikowania projektu Google to Testing , więc token odświeżania wygasa co 7 dni i otrzymuje 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 , wykonując te instrukcje, aby uniknąć wygaśnięcia tokenu odświeżania po 7 dniach.
|
Wskazówki dotyczące profilaktyki |
Zapoznaj się z artykułem Niezweryfikowane aplikacje.
|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
Podsumowanie | Operatora nie można używać w przypadku podklasy reklamy. |
Typowe przyczyny |
próbujesz zmodyfikować atrybuty inne niż status reklamy.
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Po utworzeniu reklamy nie można jej modyfikować. Jeśli chcesz zmodyfikować reklamę, musisz utworzyć nową, a potem usunąć starą. status reklamy można jednak zmodyfikować za pomocą wywołania MutateAdGroupAds.
|
|
INVALID_INPUT |
Podsumowanie | Jedno z pol w reklamie zawiera nieprawidłowe znaki. |
Typowe przyczyny |
Używanie znaków specjalnych w adresach URL.
|
Jak postępować w przypadku |
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 pol w reklamie było dłuższe niż dozwolona maksymalna długość. Zobacz Reklamy tekstowe. |
Typowe przyczyny |
Za długi wiersz tekstu.
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Przed wysłaniem żądania do interfejsu API sprawdź długość linii.
|
|
|
AD_GROUP_AD_LABEL_ALREADY_EXISTS |
Podsumowanie | Ta etykieta jest już powiązana z niektórymi reklamami. |
Typowe przyczyny |
Próbujesz powiązać etykietę z reklamami, które są już powiązane.
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Najpierw sprawdź, czy etykieta, którą chcesz dodać, nie jest już powiązana z reklamami.
|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD |
Podsumowanie | Operacja próbowała zaktualizować usuniętą reklamę. |
Typowe przyczyny |
Po usunięciu reklamy nie można jej już aktualizować, w tym zmieniać jej stanu.
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Upewnij się, że kod nie próbuje aktualizować usuniętych reklam.
|
|
|
INVALID_KEYWORD_TEXT |
Podsumowanie | Tekst słowa kluczowego zawiera nieprawidłowe znaki. Zobacz Dodawanie słów kluczowych. |
Typowe przyczyny |
Tekst słowa kluczowego zawiera nieprawidłowe znaki.
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Przed wysłaniem żądania do interfejsu API sprawdź tekst w swojej aplikacji.
|
|
|
DUPLICATE_ADGROUP_NAME |
Podsumowanie | Dodawana lub przemianowana grupa reklam ma nazwę, która jest już używana przez inną grupę reklam. |
Typowe przyczyny |
Tworzenie nowej grupy reklam o nazwie istniejącej aktywnej lub wstrzymanej grupy reklam.
|
Jak postępować w przypadku |
Zarejestruj błąd i wyświetl komunikat o błędzie, opcjonalnie sugerując niepowtarzalną nazwę grupy reklam lub wyświetlając listę używanych nazw.
|
Wskazówki dotyczące profilaktyki |
Nie dotyczy
|
|
|
DUPLICATE_ASSET |
Podsumowanie | 2 operacje w jednym żądaniu zawierają operację tworzenia komponentu z tymi samymi danymi binarnymi. |
Typowe przyczyny |
żądanie z duplikowanymi operacjami tworzenia zawierającymi te same dane binarne.
|
Jak postępować w przypadku |
Utwórz zasób w osobnym żądaniu, a potem połącz go w kolejnych żądaniach. Możesz też użyć tymczasowego identyfikatora w tym samym żądaniu.
|
Wskazówki dotyczące profilaktyki |
Nie dotyczy
|
|
|
CLIENT_CUSTOMER_ID_INVALID |
Podsumowanie | Identyfikator klienta nie jest liczbą. |
Typowe przyczyny |
Używanie nieprawidłowego identyfikatora klienta.
|
Jak postępować w przypadku |
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 | Identyfikator klienta nie został podany w nagłówku HTTP. |
Typowe przyczyny |
Nieokreślony w nagłówku HTTP identyfikator klienta.
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Identyfikator klienta jest wymagany we wszystkich wywołaniach, dlatego upewnij się, że został on określony w nagłówku HTTP. Zastanów się nad skorzystaniem z naszych bibliotek klienta, które załatwią to 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 przed utworzeniem na zapleczu.
|
Jak postępować w przypadku |
Odczekaj 5 minut, a następnie próbuj ponownie co 30 sekund.
|
Wskazówki dotyczące profilaktyki |
Zanim wyślesz żądania dotyczące konta, odczekaj kilka minut od jego utworzenia.
|
|
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ć w przypadku |
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 |
przechowywać i wykorzystywać tokeny dostępu do momentu ich wygaśnięcia.
|
|
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 włączono Google Ads.
|
Jak postępować w przypadku |
Pamiętaj, aby zalogować się na prawidłowe konto Google Ads (zazwyczaj jest to konto menedżera) w ramach procesu OAuth. 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 konto klienta lub menedżera, przejdź do 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 jest nieprawidłowy.
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Sprawdź, czy został przekazany 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, pamiętaj, aby uzyskać token odświeżania dla tego konta. Więcej informacji znajdziesz w artykule o tokenach dostępu i tokenach odświeżania oraz w artykule o OAuth2.
|
|
|
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 jeszcze zarejestrowane lub zostało dezaktywowane.
|
Jak postępować w przypadku |
Zaloguj się w interfejsie Google Ads i sprawdź, czy proces rejestracji na tym koncie został już ukończony. Informacje o dezaktywowanych kont znajdziesz w artykule Ponowna aktywacja zlikwidowanego konta Google Ads.
|
Wskazówki dotyczące profilaktyki |
Możesz sprawdzić, czy konto klienta zostało wyłączone, sprawdzając stan ZLIKWIDOWANE.
|
|
DEVELOPER_TOKEN_NOT_APPROVED |
Podsumowanie | Token dewelopera jest zatwierdzony tylko do użytku na kontach testowych, a próba uzyskania dostępu do konta, które nie jest kontem testowym, zakończyła się niepowodzeniem. |
Typowe przyczyny |
Do uzyskania dostępu do konta, które nie jest kontem testowym, użyto testowego tokena dewelopera.
|
Jak postępować w przypadku |
Upewnij się, że chcesz uzyskać dostęp do konta, które nie jest kontem testowym. Jeśli tak, musisz zgłosić się o przekształcenie tokenu dewelopera w token o standardowym lub podstawowym dostępie.
|
Wskazówki dotyczące profilaktyki |
Nie dotyczy
|
|
DEVELOPER_TOKEN_PROHIBITED |
Podsumowanie | Token dewelopera jest niedozwolony w projekcie przesłanym w żądaniu. |
Typowe przyczyny |
Każdy projekt w Konsoli interfejsów API Google może być powiązany tylko z tokenem programisty 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żywasz nowego projektu w Konsoli interfejsów API Google, podczas wysyłania żądania otrzymasz błąd DEVELOPER_TOKEN_PROHIBITED .
|
Jak postępować w przypadku |
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ń Google Ads API, które używają tokenu nowego menedżera.
|
|
USER_PERMISSION_DENIED |
Podsumowanie | Upoważniony klient nie ma dostępu do konta 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ć w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Jako identyfikator konta menedżera podaj wartość login-customer-id bez myślników (- ). Biblioteki klienta mają wbudowane odpowiednie funkcje.
|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
Podsumowanie | Wartość stawki nie jest wielokrotnością minimalnej jednostki waluty na koncie. Przykład: 0, 015 USD (15000 w mikrosekundach) nie jest prawidłową stawką. |
Typowe przyczyny |
Nie dotyczy
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Sprawdź, czy stawki są wielokrotnością minimalnej jednostki waluty na koncie.
|
|
BID_TOO_BIG |
Podsumowanie | Ten błąd jest zwracany, mimo że stawka mieści się w budżecie kampanii. |
Typowe przyczyny |
Nie dotyczy
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Sprawdź, czy konto bierze udział w programie Google Ad Grants. W takim przypadku ogranicz stawki CPC do maksimum określonego przez program.
|
|
|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC |
Podsumowanie | Kwota budżetu jest za mała. |
Typowe przyczyny |
Nie dotyczy
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Sprawdź, czy kwota budżetu jest równa lub większa niż minimalna jednostka waluty na koncie.
|
|
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT |
Podsumowanie | Po przekształceniu z mikrokwoty na kwotę w walucie konta kwota budżetu będzie miała zbyt wiele miejsc po przecinku. |
Typowe przyczyny |
Nie dotyczy
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Sprawdź, czy kwota budżetu jest podzielna przez minimalną jednostkę waluty konta.
|
|
|
DUPLICATE_CAMPAIGN_NAME |
Podsumowanie | Dodawana lub przemiatana kampania ma nazwę, która jest już używana przez inną kampanię. |
Typowe przyczyny |
utworzyć nową kampanię o nazwie istniejącej aktywnej lub wstrzymanej kampanii;
|
Jak postępować w przypadku |
Zarejestruj błąd i wyświetl komunikat o błędzie dla użytkownika, sugerując opcjonalnie unikalną nazwę kampanii lub wyświetlając listę używanych nazw.
|
Wskazówki dotyczące profilaktyki |
Nie dotyczy
|
|
|
KEYWORD_HAS_INVALID_CHARS |
Podsumowanie | dodawanie lub edytowanie słów kluczowych zawierających nieprawidłowe znaki. |
Typowe przyczyny |
Używanie w słowach kluczowych znaków specjalnych, np. ! @ % * .
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Upewnij się, że w słowach kluczowych nie używasz niedozwolonych znaków. Zobacz Dodawanie słów kluczowych.
|
|
|
DUPLICATE_ELEMENT |
Podsumowanie | Żądanie zawiera 2 parametry, które są identyczne i niepotrzebne. |
Typowe przyczyny |
Nie dotyczy
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Przed wysłaniem żądania usuń duplikaty (operacje, parametry, elementy listy). Odszukaj pola z ograniczeniem DistinctElements .
|
|
|
DEADLINE_EXCEEDED |
Podsumowanie | Upłynął limit czasu żądania i nie udało się go zrealizować na tyle szybko, aby zdążyć z odpowiedzią. |
Typowe przyczyny |
przesłano żądanie wyszukiwania, które wygenerowało zbyt dużą odpowiedź lub żądanie modyfikacji było zbyt duże, aby je przetworzyć;
|
Jak postępować w przypadku |
Zaczekaj około 30 sekund i spróbuj jeszcze raz. Jeśli błąd się powtarza, podziel żądanie na kilka mniejszych żądań, które można wykonać szybciej.
|
Wskazówki dotyczące profilaktyki |
Zapoznaj się z informacjami na temat segmentacji, aby zrozumieć, jak może ona wpływać na rozmiar odpowiedzi. Pamiętaj o ograniczeniach warstwy transportowej gRPC.
|
|
INTERNAL_ERROR |
Podsumowanie | Podczas przetwarzania żądania wystąpił nieoczekiwany błąd. |
Typowe przyczyny |
Interfejs API nie działa prawidłowo z powodu błędu.
|
Jak postępować w przypadku |
Ponowne próby wysyłania żądań, które zakończyły się niepowodzeniem z powodu tego błędu, z wykorzystaniem harmonogramu wzrastającego czasu do ponowienia.
|
Wskazówki dotyczące profilaktyki |
Nie dotyczy
|
|
TRANSIENT_ERROR |
Podsumowanie | Wystąpił przejściowy błąd wewnętrzny. Należy spróbować ponownie. |
Typowe przyczyny |
Ten błąd występuje, gdy interfejs API napotka tymczasowy problem wewnętrzny.
|
Jak postępować w przypadku |
Ponowne próby wysyłania żądań, które zakończyły się niepowodzeniem z powodu tego błędu, z wykorzystaniem harmonogramu wzrastającego czasu 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 przesyłającej żądanie. Może się tak zdarzyć, gdy przykład generowania danych uwierzytelniających użytkownika zostanie uruchomiony więcej niż raz z użyciem tych samych danych klienta OAuth i użytkownika upoważniającego.
|
Jak postępować w przypadku |
Aby wygenerować token odświeżania dla danej kombinacji danych logowania użytkownika i klienta OAuth, unieważnij istniejący token odświeżania. Pamiętaj, że cofnięcie tokenu powoduje, że nie można go używać do uzyskiwania dostępu do interfejsu Google Ads API, a także unieważnia wszystkie tokeny dostępu, które zostały wygenerowane przy użyciu tokena odświeżania.
|
Wskazówki dotyczące profilaktyki |
Aby uniknąć konieczności odtwarzania, przechowuj token odświeżania w bezpiecznym miejscu.
|
|
|
RESOURCE_NOT_FOUND |
Podsumowanie | Żądanie odnosiło się do zasobu, którego nie udało się znaleźć. |
Typowe przyczyny |
W żądaniu podano próbę zmodyfikowania zasobu, który nie istnieje lub został usunięty. Może też być tak, że podana nazwa zasobu jest zniekształcona.
|
Jak postępować w przypadku |
Zanim prześlesz żądanie zmodyfikowania zasobu, użyj zapytania wyszukiwania, aby pobrać nazwę istniejącego zasobu. Zapoznaj się z przewodnikiem biblioteki klienta, który zawiera dokumentację na temat 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.
|
|
|
EMPTY_LIST |
Podsumowanie | Wymagana lista jest pusta. |
Typowe przyczyny |
Przekazywanie pustej listy operacji do metody mutate .
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Nie dotyczy
|
|
|
RESOURCE_EXHAUSTED |
Podsumowanie | Przekroczono limit częstotliwości systemowej. |
Typowe przyczyny |
Nie dotyczy
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Ustaw krótkie opóźnienia między żądaniami lub połącz więcej operacji w mniejszej liczbie żądań.
|
|
|
TOO_LOW |
Podsumowanie | Wartość była niższa niż minimalna dozwolona. |
Typowe przyczyny |
zapomnienie o określeniu identyfikatora, co powoduje przekazanie wartości 0 ;
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Zwróć uwagę na ograniczenia zakresu opisane w dokumentacji interfejsu API.
|
|
|
INVALID_INPUT |
Podsumowanie | Żądanie ma nieprawidłowy format. |
Typowe przyczyny |
Adres URL lub treść żądania ma nieprawidłowy format.
|
Jak postępować w przypadku |
Nie dotyczy
|
Wskazówki dotyczące profilaktyki |
Nie dotyczy
|
|
REQUIRED_FIELD_MISSING |
Podsumowanie | W prośbie brakuje wymaganych informacji. |
Typowe przyczyny |
Brak wymaganych pól podczas próby dodania elementu.
|
Jak postępować w przypadku |
Zarejestruj błąd i wyświetl użytkownikowi komunikat o błędzie. Atrybut fieldPath błędu wskazuje, którego pola brakuje.
|
Wskazówki dotyczące profilaktyki |
Aby dowiedzieć się, które pola są wymagane, zapoznaj się z dokumentacją interfejsu API.
|
|
|
RESOURCE_LIMIT |
Podsumowanie | Żądanie próbuje utworzyć zasób, który spowodowałby przekroczenie łącznej liczby tych zasobów określonego limitu. |
Typowe przyczyny |
Liczba zasobów, które mogą występować w określonych kontekstach, jest ograniczona.
|
Jak postępować w przypadku |
Sprawdź, który limit jest osiągany, przeglądając limity systemu. Użyj istniejącego zasobu lub usuń zasoby, aby zrobić miejsce na nowe.
|
Wskazówki dotyczące profilaktyki |
Za pomocą zapytań wyszukiwania możesz sprawdzać liczbę zasobów, które mają ograniczenia.
|
|
|
TOO_LONG |
Podsumowanie | Ciąg znaków przypisany do określonego pola jest dłuższy niż dozwolony limit. |
Typowe przyczyny |
Nagłówki lub teksty reklamy zawierają zbyt dużo tekstu.
|
Jak postępować w przypadku |
Określ ograniczenie , które występuje, odpowiednio zmodyfikuj ciąg znaków i ponownie wyślij żądanie.
|
Wskazówki dotyczące profilaktyki |
Pamiętaj o ograniczeniach długości ciągu znaków.
|
|
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: 2024-12-02 UTC.
[null,null,["Ostatnia aktualizacja: 2024-12-02 UTC."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]