Najczęstsze błędy
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie opisujemy najczęstsze błędy zwracane przez interfejs API Google Ad Managera. Błędy są zwracane w formacie Error.REASON:
EntityChildrenLimitReachedError
- 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ć.
QuotaError.EXCEEDED_QUOTA
- 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.
AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
- 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.
AuthenticationError.NETWORK_CODE_REQUIRED
- 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.
AuthenticationError.NETWORK_NOT_FOUND
- 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ć.
AuthenticationError.NO_NETWORKS_TO_ACCESS
- 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.
AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS
- 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.
-
PermissionError.PERMISSION_DENIED
- 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.
ApiVersionError.UPDATE_TO_NEWER_VERSION
- 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.
Błąd 404
- 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.
Błąd cofania marszru
- 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.
-
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: 2025-08-21 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-21 UTC."],[[["\u003cp\u003eThis page lists common Google Ad Manager API errors and offers troubleshooting tips.\u003c/p\u003e\n"],["\u003cp\u003eErrors are categorized by type, such as authentication, permission, and quota errors.\u003c/p\u003e\n"],["\u003cp\u003eEach error description includes a summary, common causes, and recommended handling tips.\u003c/p\u003e\n"],["\u003cp\u003eUsers are encouraged to stay updated on API versions and subscribe to the Ad Manager API forum and blog for the latest news.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing client libraries for generating valid SOAP requests is recommended to avoid unmarshalling errors.\u003c/p\u003e\n"]]],[],null,["# Common Errors\n\nThis page describes the most frequently encountered errors returned by the\nGoogle Ad Manager API. Errors are returned in the format\n`Error.REASON`:\n\n- [`EntityChildrenLimitReachedError`](#EntityChildrenLimitReachedError)\n- [`QuotaError.EXCEEDED_QUOTA`](#QuotaError.EXCEEDED_QUOTA)\n- [`AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`](#AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK)\n- [`AuthenticationError.NETWORK_CODE_REQUIRED`](#AuthenticationError.NETWORK_CODE_REQUIRED)\n- [`AuthenticationError.NETWORK_NOT_FOUND`](#AuthenticationError.NETWORK_NOT_FOUND)\n- [`AuthenticationError.NO_NETWORKS_TO_ACCESS`](#AuthenticationError.NO_NETWORKS_TO_ACCESS)\n- [`AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`](#AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS)\n- [`PermissionError.PERMISSION_DENIED`](#PermissionError.PERMISSION_DENIED)\n- [`ApiVersionError.UPDATE_TO_NEWER_VERSION`](#ApiVersionError.UPDATE_TO_NEWER_VERSION)\n- [404 Error](#404Error)\n- [Unmarshalling Errors](#Unmarshalling)\n\n[Entity limit errors](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError)\n-------------------------------------------------------------------------------------------------------\n\n### `EntityChildrenLimitReachedError`\n\nSummary\n: The maximum number of allowed children has been reached for the entity\n and no more children can be added to that entity.\n\nRecommended handling tips\n: Create a new type of the entity that has reached the max allowed number\n of children and add the child entity you are trying to create to the new one.\n For example if you receive [LINE_ITEM_LIMIT_FOR_ORDER_REACHED](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError.Reason#LINE_ITEM_LIMIT_FOR_ORDER_REACHED),\n then you will need to create a new order and add the line item you are trying\n to create to that new order.\n\n[Quota errors](/ad-manager/api/reference/latest/NetworkService.QuotaError)\n--------------------------------------------------------------------------\n\n### `QuotaError.EXCEEDED_QUOTA`\n\nSummary\n: The number of requests made per second is too high and has exceeded the\n allowable limit.\n\nRecommended handling tips\n:\n - Use batch methods such as [updateLineItems](/ad-manager/api/reference/latest/LineItemService#updateLineItems) by gathering changes locally and making a single request to fulfill those changes all at once.\n - Wait about 5 seconds and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. This is recommended for interactive applications integrating with Ad Manager that are used in real time.\n - Limit requests to 2 per second for Ad Manager networks, or 8 per second for Ad Manager 360 networks. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error. This is recommended for applications integrating with Ad Manager that do not have real time interaction, such as running nightly reports.\n\n[Authentication errors](/ad-manager/api/reference/latest/NetworkService.AuthenticationError)\n--------------------------------------------------------------------------------------------\n\n### `AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`\n\nSummary\n: The user tried to create a test network using an account that already is\n associated with a network.\n\nCommon causes\n: The user did not create a new Google account first before calling\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Create a brand new account before calling\n `NetworkService.makeTestNetwork()`. See [how to create a test network](/ad-manager/api/start#enable_api) for more\n information.\n\n### `AuthenticationError.NETWORK_CODE_REQUIRED`\n\nSummary\n: The user did not provide a `networkCode`. To make the request,\n a network code is required.\n\nCommon causes\n: Network codes are required for all requests except\n `NetworkService.getAllNetworks()` and\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Include the network code of the network being addressed in the request\n header. Only use a network code available to your account login. You can find\n the code on the Ad Manager website for your account, on the Admin \\\u003e Network\n Settings page next to \"Network code\". More information about setting your\n network code can be found on the [SOAP XML request and\n response headers](/ad-manager/api/soap_xml) page.\n\n### `AuthenticationError.NETWORK_NOT_FOUND`\n\nSummary\n: The request could not be made because the network code provided in the\n configuration is not found on the server.\n\nCommon causes\n: You have specified an incorrect network code in your configuration.\n\nRecommended handling tips\n: The \"trigger\" field of the error log will often suggest the correct\n network for the user.\n\n### `AuthenticationError.NO_NETWORKS_TO_ACCESS`\n\nSummary\n: The user is not associated with any network.\n\nCommon causes\n: You have not enabled your production account for API access.\n\nRecommended handling tips\n: Enable API access to your production environment. See [Enabling API Access](/ad-manager/api/start#enable_api) for information.\n\n### `AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`\n\nSummary\n: The customer is not whitelisted for API access.\n\nCommon causes\n: Your network is not whitelisted for production, but you provided a [network code](/ad-manager/api/soap_xml) in the SOAP Header.\n:\n\nRecommended handling tips\n: Enable [API access](/ad-manager/api/start#enable_api).\n:\n\n[Permission errors](/ad-manager/api/reference/latest/NetworkService.PermissionError)\n------------------------------------------------------------------------------------\n\n### `PermissionError.PERMISSION_DENIED`\n\nSummary\n: The user does not have the required permission for the request.\n\nCommon causes\n:\n - You tried to access an object that exists in another network.\n - You tried to access an object that exists in your network, but you don't have permission to read or update.\n - You tried to perform a task that requires an additional feature to enabled on your account.\n\nRecommended handling tips\n:\n - If you are creating a UI, indicate to the user that they did not have permission to perform this action and to speak to their Administrator.\n - If you tried performing a task, such as one involving a premium-only feature that your network does not have permission to do, speak to your account manager about enabling this feature.\n - Remember, test networks are, by default, not Ad Manager 360 networks, meaning that they do not have the premium features found in Ad Manager 360 networks. Speak to your account manager to enable features on your test network.\n\n[Version errors](/ad-manager/api/reference/latest/NetworkService.ApiVersionError)\n---------------------------------------------------------------------------------\n\n### `ApiVersionError.UPDATE_TO_NEWER_VERSION`\n\nSummary\n: The application either: initiated a request that requires a newer version\n to succeed; or initiated a request to a deprecated version.\n\nCommon causes\n:\n - The version of the API call has been deprecated. Please subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) for deprecation announcements.\n - The request you made requires a newer version of the API to succeed. This is often the case where a feature has been introduced in the UI and in order for the API to send the object correctly, it needs a newer version of the API.\n\nRecommended handling tips\n:\n - Stay up to date on API versions; plan on upgrading regularly.\n - Subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) to be notified about deprecations.\n\n404 Error\n---------\n\nSummary\n: Your request did not reach the server.\n\nCommon causes\n: Your internet connection or proxy may be misconfigured. The version of\n the API you are calling may also be sunsetted.\n:\n\nRecommended handling tips\n: Check your internet or proxy configuration and make sure you are using a\n recent version of the API. You may want to upgrade your client library to\n the most recent version as well.\n:\n\nPrevention tips\n: Subscribe to the [Ad\n Manager API forum](//groups.google.com/group/google-doubleclick-for-publishers-api) and check our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api)\n to stay updated on the latest Ad Manager API news.\n\nUnmarshalling Error\n-------------------\n\nSummary\n: The SOAP XML in your request did not conform to the WSDL\n specification.\n\nCommon causes\n: The request contains fields or entities not included in the WSDL\n specification, or in the wrong namespace.\n:\n: There is a type mismatch in the request (e.g., an integer field has a\n string value).\n:\n\nRecommended handling tips\n: Ensure that your request conforms to the WSDL specification.\n:\n: Use a [client library](/ad-manager/api/clients) to generate\n valid SOAP, and use this for comparison. All client libraries support\n logging of SOAP requests and responses.\n:"]]
