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 limitu elementów

Podsumowanie: Osiągnięto maksymalną dozwoloną liczbę elementów podrzędnych dla elementu i nie można dodać do niego kolejnych 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 encję podrzędną, którą próbujesz utworzyć. Jeśli np. otrzymasz LINE_ITEM_LIMIT_FOR_ORDER_REACHED, musisz utworzyć nowe zamówienie i dodać do niego element, który próbujesz utworzyć.

Podsumowanie

Liczba żądań wysłanych na sekundę jest zbyt duża i przekroczyła dozwolony limit.

Zalecane wskazówki dotyczące obsługi

Użyj metod wsadowych, takich jak updateLineItems, zbierając zmiany lokalnie i wysyłając jedno żądanie, aby zrealizować wszystkie te zmiany naraz.
Zaczekaj około 5 sekund i spróbuj ponownie. Pamiętaj, że nie gwarantuje to powodzenia żądania. Jeśli znowu się nie uda, spróbuj wydłużyć czas oczekiwania. Jest to zalecane w przypadku aplikacji interaktywnych integrujących się z Ad Managerem, które są używane w czasie rzeczywistym.
Ogranicz liczbę żądań do 2 na sekundę w przypadku sieci Ad Managera lub 8 na sekundę w przypadku sieci Ad Managera 360. Pamiętaj, że nie gwarantuje to powodzenia każdego żądania, ale może zmniejszyć liczbę wystąpień tego błędu. Jest to zalecane w przypadku aplikacji integrujących się z Ad Managerem, które nie używają interakcji w czasie rzeczywistym, np. generowania nocnych raportów.

Podsumowanie: Użytkownik próbował utworzyć sieć testową przy użyciu konta, które jest już powiązane z siecią.
Typowe przyczyny: Użytkownik nie utworzył nowego konta Google przed wywołaniem połączenia NetworkService.makeTestNetwork().
Zalecane wskazówki dotyczące obsługi: Zanim zadzwonisz pod numer NetworkService.makeTestNetwork(), utwórz nowe konto. Więcej informacji znajdziesz w artykule o tworzeniu sieci testowej.

Podsumowanie: Użytkownik nie podał elementu networkCode. Do wysłania żądania 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: Umieść kod sieci w adresie URL w nagłówku żądania. Użyj tylko kodu sieci dostępnego do logowania na konto. Znajdziesz go na stronie Ad Managera dotyczącej swojego konta, na stronie Administracja > Ustawienia sieci obok pozycji „Kod sieci”. Więcej informacji o ustawianiu kodu sieci znajdziesz na stronie nagłówków żądań i odpowiedzi XML SOAP.

Podsumowanie: Nie można zrealizować żądania, ponieważ kodu sieci podanego w konfiguracji nie znaleziono na serwerze.
Typowe przyczyny: W konfiguracji jest nieprawidłowy kod sieci.
Zalecane wskazówki dotyczące obsługi: Pole „aktywator” w logu błędów często podpowiada użytkownikowi właściwą sieć.

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

Podsumowanie: Klient nie znajduje się 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 aplikacji produkcyjnych, ale w nagłówku SOAP podano kod sieci.
Zalecane wskazówki dotyczące obsługi: Włącz dostęp przez interfejs API.

Podsumowanie

Użytkownik nie ma uprawnień wymaganych do realizacji tego żą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 odczytu lub 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 użytkownika, poinformuj użytkownika, że nie ma uprawnień do wykonania tej czynności, i skontaktuj się z administratorem.
Jeśli próbujesz wykonać zadanie, na przykład dotyczące funkcji dostępnej tylko w wersji premium, do której Twoja sieć nie ma uprawnień, 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, które są dostępne w sieciach Ad Managera 360. Aby włączyć funkcje w sieci testowej, skontaktuj się z menedżerem konta.

Podsumowanie

Aplikacja: zainicjowała żądanie, które wymaga nowszej wersji, aby odnieść sukces, lub zainicjowała żądanie do wycofanej wersji.

Typowe przyczyny

Wersja wywołania interfejsu API została wycofana. Zasubskrybuj naszego bloga, aby być na bieżąco z powiadomieniami o wycofaniu tych usług.
Aby żądanie mogło zostać zrealizowane, wymagana jest nowsza wersja interfejsu API. Często zdarza się, że funkcja została wprowadzona w interfejsie użytkownika i aby interfejs API prawidłowo wysłał obiekt, potrzebna jest jego nowsza wersja.

Zalecane wskazówki dotyczące obsługi

Bądź na bieżąco z wersjami interfejsu API i zaplanuj regularne uaktualnienia.
Aby otrzymywać powiadomienia o wycofanych produktach, zasubskrybuj naszego bloga.

Podsumowanie: Twoje żądanie nie dotarło do serwera.
Typowe przyczyny: Połączenie internetowe lub serwer proxy mogą być nieprawidłowo skonfigurowane. Wywoływana przez Ciebie wersja interfejsu API też może 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. Być może warto uaktualnić bibliotekę klienta do najnowszej wersji.
Wskazówki dotyczące profilaktyki: Zasubskrybuj forum interfejsu API Ad Managera i czytaj naszego bloga, aby być na bieżąco z najnowszymi informacjami o interfejsie API Ad Managera.

Podsumowanie: Plik XML SOAP w Twoim żądaniu nie jest zgodny ze specyfikacją WSDL.
Typowe przyczyny: Żądanie zawiera pola lub elementy nieuwzględnione w specyfikacji WSDL lub znajdujące się w nieprawidłowej przestrzeni nazw.; W żądaniu jest niezgodny typ (np. pole liczby całkowitej zawiera wartość ciągu).
Zalecane wskazówki dotyczące obsługi: Dopilnuj, aby Twoje żądanie było zgodne ze specyfikacją WSDL.; Użyj biblioteki klienta, aby wygenerować prawidłowy protokół SOAP, i wykorzystaj go do porównania. Wszystkie biblioteki klienta obsługują logowanie żądań i odpowiedzi SOAP.