Najczęstsze błędy

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

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

EntityChildrenLimitReachedError

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

Błędy limitu

QuotaError.EXCEEDED_QUOTA

Podsumowanie
Liczba żądań na sekundę jest zbyt wysoka i przekracza dopuszczalny limit.
Zalecane wskazówki dotyczące obsługi
  • Korzystaj z metod zbiorczych, takich jak updateLineItems, zbierając zmiany lokalnie i wysyłając jedno żądanie, aby wprowadzić je wszystkie naraz.
  • Zaczekaj około 5 sekund i spróbuj jeszcze raz. Pamiętaj, że nie gwarantuje to powodzenia żądania. Jeśli ponownie się nie powiedzie, spróbuj zwiększyć czas oczekiwania. Jest to zalecane w przypadku interaktywnych aplikacji zintegrowanych z usługą Ad Manager, 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żda prośba zostanie zrealizowana, ale może pomóc zmniejszyć liczbę przypadków, w których otrzymasz ten błąd. Jest to zalecane w przypadku aplikacji zintegrowanych z Ad Managerem, które nie wchodzą w interakcje w czasie rzeczywistym, np. w przypadku generowania raportów nocnych.

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ł najpierw nowego konta Google przed wykonaniem połączenia. NetworkService.makeTestNetwork()
Zalecane wskazówki dotyczące obsługi
Przed wywołaniem 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, wymagany jest 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
W nagłówku żądania podaj kod sieci, do której jest ono kierowane. Używaj tylko kodu sieci dostępnego na koncie, na które się logujesz. Kod znajdziesz w usłudze Ad Manager na stronie Administracja > Ustawienia sieci obok pozycji „Kod sieci”. Więcej informacji o ustawianiu kodu sieci znajdziesz na stronie Nagłówki żądania i odpowiedzi SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

Podsumowanie
Nie udało się wysłać żądania, ponieważ kodu sieci podanego w konfiguracji nie znaleziono 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
Na Twoim koncie produkcyjnym nie włączono dostępu do interfejsu API.
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 przez interfejs API.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Podsumowanie
Klient nie jest na białej liście użytkowników mających dostęp do interfejsu API.
Typowe przyczyny
Twoja sieć nie znajduje się na białej liście w przypadku wersji produkcyjnej, 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 wymaganych uprawnień do wykonania żądania.
Typowe przyczyny
  • Próbujesz uzyskać dostęp do obiektu, który znajduje się w innej sieci.
  • Próbowano uzyskać dostęp do obiektu, który istnieje w sieci, ale nie masz uprawnień do jego odczytywania ani aktualizowania.
  • 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 poproś go o kontakt z administratorem.
  • Jeśli podczas wykonywania zadania, np. związanego z funkcją dostępną tylko w wersji premium, do którego Twoja sieć nie ma uprawnień, pojawi się błąd, poproś menedżera konta o włączenie tej funkcji.
  • Pamiętaj, że sieci testowe domyślnie nie są 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. Aby otrzymywać powiadomienia o wycofywaniu funkcji, zasubskrybuj nasz blog.
  • Żądanie, które zostało przez Ciebie wysłane, wymaga nowszej wersji interfejsu API. Często zdarza się to, gdy w interfejsie wprowadzono nową funkcję, a aby interfejs API mógł prawidłowo wysyłać obiekt, potrzebuje nowszej wersji.
Zalecane wskazówki dotyczące obsługi
  • Bądź na bieżąco z wersjami interfejsu API i regularnie planuj uaktualnienia.
  • 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, z której korzystasz, 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 demarshalizacji

Podsumowanie
Kod XML SOAP w Twoim żądaniu nie jest zgodny ze specyfikacją WSDL.
Typowe przyczyny
Żądanie zawiera pola lub jednostki, które nie są uwzględnione w specyfikacji WSDL lub znajdują się w nieprawidłowej przestrzeni nazw.
W żądaniu występuje niezgodność typów (np. pole całkowite ma wartość w formacie ciągu znaków).
Zalecane wskazówki dotyczące obsługi
Upewnij się, że Twoje żą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.