Najczęstsze błędy

Na tej stronie opisujemy najczęstsze błędy zwracane przez interfejs API Google Ad Managera. Błędy są zwracane w formacie Error.REASON:

Błędy związane z limitami elementów

EntityChildrenLimitReachedError

Podsumowanie
Osiągnięto maksymalną liczbę dozwolonych elementów podrzędnych encji i nie można dodać do niej więcej elementów podrzędnych.
Zalecane wskazówki dotyczące obsługi
Utwórz nowy typ elementu, który osiągnął maksymalną dozwoloną liczbę elementów podrzędnych, i dodaj do niego element podrzędny, który próbujesz utworzyć. Jeśli na przykład otrzymasz komunikat LINE_ITEM_LIMIT_FOR_ORDER_REACHED, musisz utworzyć nowe zamówienie i dodać do niego element zamówienia, który próbujesz utworzyć.

Błędy związane z limitami

QuotaError.EXCEEDED_QUOTA

Podsumowanie
Liczba żądań na sekundę jest zbyt wysoka i przekroczyła dozwolony limit.
Zalecane wskazówki dotyczące obsługi
  • Używaj metod zbiorczych, takich jak updateLineItems, zbierając zmiany lokalnie i wysyłając pojedyncze żądanie, aby wprowadzić je wszystkie naraz.
  • Zaczekaj około 5 sekund i spróbuj jeszcze raz. Pamiętaj, że nie gwarantuje to, że żądanie zostanie zrealizowane. Jeśli błąd wystąpi ponownie, spróbuj wydłużyć czas oczekiwania. Zalecamy to w przypadku aplikacji interaktywnych zintegrowanych z Ad Managerem, które są używane w czasie rzeczywistym.
  • Ogranicz liczbę żądań do 2 na sekundę w przypadku sieci Ad Managera lub do 8 na sekundę w przypadku sieci Ad Managera 360. Nie gwarantuje to, że każde żądanie zostanie zrealizowane, ale może pomóc zmniejszyć liczbę błędów. Zalecamy to w przypadku aplikacji zintegrowanych z Ad Managerem, które nie wymagają interakcji w czasie rzeczywistym, np. generujących raporty nocne.

Błędy uwierzytelniania

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Podsumowanie
Użytkownik próbował utworzyć sieć testową za pomocą konta, które jest już powiązane z siecią.
Typowe przyczyny
Użytkownik nie utworzył nowego konta Google przed wywołaniem metody NetworkService.makeTestNetwork().
Zalecane wskazówki dotyczące obsługi
Przed rozmową telefoniczną utwórz nowe konto.NetworkService.makeTestNetwork() Więcej informacji znajdziesz w artykule o tworzeniu sieci testowej.

AuthenticationError.NETWORK_CODE_REQUIRED

Podsumowanie
Użytkownik nie podał networkCode. Aby wysłać żądanie, musisz podać kod sieci.
Typowe przyczyny
Kody sieci są wymagane w przypadku wszystkich żądań z wyjątkiem NetworkService.getAllNetworks() i NetworkService.makeTestNetwork().
Zalecane wskazówki dotyczące obsługi
Dołącz kod sieci, do której odnosi się żądanie, w nagłówku żądania. Używaj tylko kodu sieci dostępnego dla Twojego loginu do konta. Kod znajdziesz na stronie Ad Managera na swoim koncie, na stronie Administracja > Ustawienia sieci obok „Kod sieci”. Więcej informacji o ustawianiu kodu sieci znajdziesz na stronie Nagłówki żądań i nagłówki odpowiedzi SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

Podsumowanie
Nie udało się wysłać żądania, ponieważ kod sieci podany w konfiguracji nie został znaleziony na serwerze.
Typowe przyczyny
W konfiguracji podano nieprawidłowy kod sieci.
Zalecane wskazówki dotyczące obsługi
Pole „trigger” w dzienniku błędów często sugeruje prawidłową sieć dla użytkownika.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Podsumowanie
Użytkownik nie jest powiązany z żadną siecią.
Typowe przyczyny
Nie masz włączonego dostępu do interfejsu API na koncie produkcyjnym.
Zalecane wskazówki dotyczące obsługi
Włącz dostęp do interfejsu API w środowisku produkcyjnym. Więcej informacji znajdziesz w artykule Włączanie dostępu do interfejsu API.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Podsumowanie
Klient nie znajduje się na liście dozwolonych, aby mieć dostęp do interfejsu API.
Typowe przyczyny
Twoja sieć nie znajduje się na liście dozwolonych w środowisku produkcyjnym, ale w nagłówku SOAP podano kod sieci.
Zalecane wskazówki dotyczące obsługi
Włącz dostęp do interfejsu API.

Błędy uprawnień

PermissionError.PERMISSION_DENIED

Podsumowanie
Użytkownik nie ma uprawnień wymaganych do wykonania żądania.
Typowe przyczyny
  • Próbujesz uzyskać dostęp do obiektu, który istnieje w innej sieci.
  • Próbujesz uzyskać dostęp do obiektu, który istnieje w Twojej sieci, ale nie masz uprawnień do jego odczytu ani aktualizacji.
  • Próbujesz wykonać zadanie, które wymaga włączenia na koncie dodatkowej funkcji.
Zalecane wskazówki dotyczące obsługi
  • Jeśli tworzysz interfejs, poinformuj użytkownika, że nie ma uprawnień do wykonania tej czynności i powinien skontaktować się z administratorem.
  • Jeśli próbujesz wykonać zadanie, np. związane z funkcją premium, do której Twoja sieć nie ma uprawnień, skontaktuj się z menedżerem konta, aby włączyć tę funkcję.
  • Pamiętaj, że sieci testowe nie są domyślnie sieciami Ad Managera 360, co oznacza, że nie mają funkcji premium dostępnych w sieciach Ad Managera 360. Aby włączyć funkcje w sieci testowej, skontaktuj się z menedżerem konta.

Błędy wersji

ApiVersionError.UPDATE_TO_NEWER_VERSION

Podsumowanie
Aplikacja zainicjowała żądanie, które wymaga nowszej wersji, lub zainicjowała żądanie do wycofanej wersji.
Typowe przyczyny
  • Wersja wywołania interfejsu API została wycofana. Zasubskrybuj nasz blog, aby otrzymywać powiadomienia o wycofywaniu funkcji.
  • Przesłane żądanie wymaga nowszej wersji interfejsu API. Często zdarza się, że funkcja została wprowadzona w interfejsie, a aby interfejs API mógł prawidłowo wysłać obiekt, potrzebuje nowszej wersji.
Zalecane wskazówki dotyczące obsługi
  • Bądź na bieżąco z wersjami interfejsu API i regularnie je aktualizuj.
  • Zasubskrybuj nasz blog, aby otrzymywać powiadomienia o wycofywaniu funkcji.

Błąd 404

Podsumowanie
Twoje żądanie nie dotarło do serwera.
Typowe przyczyny
Połączenie z internetem lub serwer proxy mogą być nieprawidłowo skonfigurowane. Wersja interfejsu API, którą wywołujesz, może też zostać wycofana.
Zalecane wskazówki dotyczące obsługi
Sprawdź konfigurację internetu lub serwera proxy i upewnij się, że używasz najnowszej wersji interfejsu API. Warto też uaktualnić bibliotekę klienta do najnowszej wersji.
Wskazówki dotyczące profilaktyki
Aby być na bieżąco z najnowszymi informacjami o interfejsie API Ad Managera, odwiedzaj Forum pomocy Ad Managera i nasz blog.

Błąd unmarshallingu

Podsumowanie
Kod XML SOAP w żądaniu nie jest zgodny ze specyfikacją WSDL.
Typowe przyczyny
Żądanie zawiera pola lub elementy, których nie ma w specyfikacji WSDL, lub które znajdują się w niewłaściwej przestrzeni nazw.
W żądaniu występuje niezgodność typów (np. pole liczby całkowitej ma wartość ciągu znaków).
Zalecane wskazówki dotyczące obsługi
Upewnij się, że żądanie jest zgodne ze specyfikacją WSDL.
Użyj biblioteki klienta, aby wygenerować prawidłowy kod SOAP, i użyj go do porównania. Wszystkie biblioteki klienta obsługują rejestrowanie żądań i odpowiedzi SOAP.